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PURPOSE OF THIS MANUAL 


This reference manual provides a detailed definition of 
the machine functions performed by the processor but 
should not be considered tutorial for the IMP (internal 
microprogramming) instruction set. This manual does 
not attempt to describe how the VMC (vertical 
microcode) routines prepare the information or how the 
HMC (horizontal microcode) attempts to use it. 


This manual is to be used by support personnel for the 
maintenance of System/38. 


ORGANIZATION OF THIS MANUAL 
The information presented in this manual includes: 
Chapter Content 


2 Internal Microprogramming Structure-the 
IMP data types, the instructions, and 
permanent storage assignments. 


3 Horizontal Microcode Support 
Functions-the HMC procedures and the 
HMC built-in functions. 


4 The processor-the processor, the 
processor states, the execution functions, 
the input/output and asynchronous 
events. 


5 Tasking-the function of the IMP, the IMP 
objects the tasking function uses, the 
control of tasking, and the intertask 
communications and synchronization. 
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Chapter Content 


6 Supervisor Linkage and Exception 
Handling-the supervisor linkage concepts 
and the objects it uses, the supervisor 
linkage control, the exceptions, and the 
instruction length count and IAR 
(instruction address register) settings. 


7 Input /Output and Asynchronous Events-the 
methods used to communicate with |/O 
devices and the sources of asynchronous 
events. 


8 Virtual Storage Addressing-the storage 
addressing structure of the IMP. 


9 Machine Support Functions-the additional 
services that are available to support IMP 
instruction processing. 


10 Instructions-detailed descriptions of IMP 
instructions. 


The glossary in Appendix C includes definitions 
developed by the American National Standards Institute 
(ANSI) and the International Organization for 
Standardization (ISO). This material is reproduced from 
the American National Dictionary for Information 
Processing, copyright 1977 by the Computer Business 
Equipment Manufacturers Association, copies of which 
may be purchased from the American Standards 
Institute, 1430 Broadway, New York, New York 10018. 


WHAT YOU SHOULD KNOW 


The reader should understand computer programming 
and the concepts used in System/38 before attempting 
to use the information in this manual. 
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IF 


YOU NEED MORE INFORMATION 
IBM System/38 Bibliography, GH30-0233 


This publication describes technical publications in 
support of System/38 machine components, system 
programming, application programming, and other 
supplemental information (for example forms and 
program listings). 


IBM System/38 Functional Concepts Manual, 
GA21-9330 


This publication is designed to provide an overview of 
the System/38 concepts, a definition and description 
of structures and objects, and a description of 
specific System/38 functions. 


IBM System/38 Functional Reference Manudat, 
GA21-9331 and GA21-9800 


This publication is designed to describe the 

System /38 instruction set and contains a detailed 
description of each instruction. This publication also 
contains the specifications for objects, events, 
exceptions, and describes specialized instructions for 
source/sink devices. 


IBM System/38 Vertical Microcode Data Areas, 
SY21-0892 


This publication is designed to aid service personnel 
responsible for supporting the IBM System/38 by 
providing descriptions of the vertical microcode data 
areas within the system. 


IBM System/38 Vertical Microcode Logic Overviews 
and Component Descriptions Manual, SY21-0889 


This publication is designed to aid service personnel 
to isolate a malfunction in the System/38 vertical 
microcode. 


IBM System/38 Vertical Microcode Logic Listings, 
SYB1-0890 


This publication is designed to aid service personnel 
to isolate a malfunction in the System/38 vertical 
microcode. 


« IBM System/38 Vertical Microcode Module 


Descriptions, SYB1-0891 


This publication is designed to aid service personnel 
to isolate a malfunction in the System/38 vertical 
microcode. 


IBM System/38 Processing Unit Models 3, 4, and 5 
Theory — Maintenance, SY31-0524 and IBM 
System/38 Processing Unit Models 6, 7, and 8 
Theory — Maintenance, SY31-0649 


These publications are designed to give service 
personnel a brief description of some of the unique 
features of System/38. 


IBM System/38 Channel Theory — Maintenance, 
SY31-0619 


This publication is designed to provide maintenance 
and theory information that will be used by the 
service personnel to maintain the System/38 channel. 


IBM System/38 System Control Adapter 
Theory — Maintenance, SY31-0527 


This publication is designed to provide maintenance 
and theory information that will be used by the 
service personnel to install and maintain the IBM 
System /38. 


IBM System/38 Service Guide, SY31-0523 


This publication is designed to provide the 
information needed to use the System/38 
maintenance library and service functions. The 
publication also shows the maintenance overview, the 
maintenance library organization, the operator/service 
panel switch settings, how to use the MAPs, and 
how to select either concurrent or dedicated service 
functions. 


IBM System/38 Diagnostic Aids, SY21-0584 


This publication provides information about the tools, 
documentation, and procedures needed to aid in 
problem resolution for programming problems 
occurring within the System/38 CPF and the VMC of 
the System/38. 
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DEFINITIONS OF NOTES 


The headings Notes and Programming Notes are used 
where additional information is provided on various 
topics. Notes further explain or clarify text. 
Programming notes either explain instruction 
implementation or they suggest additional uses of 
instructions for support personnel. 


TERMINOLOGY 


Certain fields or bit combinations in IMP objects are 
undefined. Some of these may be used by the IMP 
programmer and some may not. In order to distinguish 
between them, the following terminology will be used 
throughout this manual: 


Term 


Not used 


Reserved 


Invalid 


Meaning 


The field or bit combination is not 
interrogated or modified by the 
processor and may be used by the IMP 
programmer. 


The field or bit combination is 
interrogated or modified by the 
processor and may not be used by the 
IMP programmer. 


The bit combination is checked by the 

processor and a specification exception 
or a machine check occurs if an invalid 
combination is detected. 
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Machine Product 


The IMP (internal microprogramming) instruction set is 
an internal communications link. The following figure 
shows the relationship of the instructions to other parts 
of the system. 


System/38 Machine Support 


Wy gues Ll 


Vertical 
Microcode 


Horizontal 
Microcode 


Hardware 





Chapter 1. Introduction 


The user/control program interface to the machine 
product is called the System/38 instruction set. The 
machine product that supports the System/38 
instruction set is composed of hardware and microcode. 
Microcode is further subdivided into HMC (horizontal 
microcode) and VMC (vertical microcode). Definitions of 
these terms are: 


« Hardware: A combination of silicon, copper, and 
frames providing a hardwired execution instruction 
set. 


e Microcode: Instructions providing the basic machine 
control functions and supporting the System/38 
instruction set. 


e HMC: Microcode that exhibits a high degree of 
parallelism of execution, controls the detailed state of 
the hardware, and supports the IMP instruction set. 
HMC executes the hardware instruction set. 


e VMC: Microcode that defines logical operations on 
data, iS primarily sequential in execution, and 
supports the System/38 instruction set. VMC is 
executed in the IMP instruction set. 


System Features 


The IMP instruction set provides the fundamental 
processing capabilities of the machine. It includes 
decimal operations, with decimal shifting, providing 
instructions for commercial applications. Floating-point 
provides an instruction set for scientific computation. 


Several of the instructions are executed in VMC. These 
instructions are indicated as SVL instructions in 
Appendix B. All other instructions shown in Chapter 10 
are executed in HMC. 
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Storage Descriptions 


Storage is composed of more than one technology. 
Except on performance, the effects of the physical 
differences between storage types is not observable to 
the application program. 


Fetching and storing of main storage data by the 
processor is temporarily prevented by I/O (input/output) 
data transfer operations. When concurrent |/O requests 
for access to a main storage location occur, access is 
normally granted in a priority sequence. 


If the first reference to a storage location changes the 
contents of that location, any subsequent fetches from 
that location will obtain the new contents. 
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Register Descriptions 


The hardware registers used with the processor can be 
used individually or combined to form larger registers. 
There are 16 SID (segment identifier) registers, 16 R 
(2-byte) registers, and 16 r (1-byte) registers as shown 
in the following figure. R registers hex 8-F are divided 
to form 16 single-byte registers, r(O)-r(F). The S and R 
registers are combined to form the B or base registers. 
The 16 base registers can contain addresses during IMP 
procedure execution. The address contained in base 
register 0 (B[O]) points to the start of the instruction 
stream, and all other instruction addressing and 
branching within a procedure is relative to BO. Base 
registers can be used to address areas in virtual storage 
of up to 64 K-bytes each. 


Registers—Relative Sizes 


Four Bytes Two Bytes 





Note: The number in parentheses indicates the number 
of the associated register (S, R, or r). 
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Data 


The basic building block for all IMP formats is the 8-bit 
byte. 


For the purpose of error detection and correction, one or 
more check bits are transmitted with each byte or group 
of bytes. The check bits are generated automatically by 
the hardware and cannot be directly controlled by the 
program. References in this manual to the sizes of data 
fields and registers exclude mention of the associated 
check bits. 


The storage capacity is expressed in the number of 
bytes provided without regard to the storage width 
(number of bytes fetched or stored in one storage 
cycle). 


The location of any field or group of bytes is specified 
by the address of its leftmost byte. 


The length of a field can be implied by the operation to 
be performed. When the length is implied, there is no 
corresponding length field and the field is said to have a 
fixed length. Fixed-length data can be 1, 2, 4, 6 (in the 
Load instruction), 8, 12, 16, or 32 bytes long. 


When the length of a field is not implied by the 
instruction operation code but is stated explicitly as a 
length field in the instruction or as part of the data 
accessed by the instruction, the information is said to 
have variable length. 


When information is placed in storage, the contents of 
only those byte locations included in the designated field 
are replaced, even though the width of the physical path 
may be wider than the field being stored (fewer bytes 
may be stored than the processor is capable of storing 
in one storage cycle). 


DATA TYPES 


The computational instructions of the IMP operate on 
five data types: binary, address, character, decimal, and 
floating point. 


Binary Data 


An integer can be expressed as a Signed or unsigned 
binary number. 


In an unsigned binary number, all bits express the 
absolute value of the number. When two unsigned 
binary numbers are added, the shorter number is treated 
as if extended with high-order zeros. An unsigned 
binary number can appear as a byte or halfword in 
registers, or can be of variable length (1 to 256 bytes) in 
storage. 


In signed binary numbers, the twos-complement 
representation of a negative number is considered the 
sum of the integer part of the field (taken as a positive 
number) and the maximum negative number. This is 
obtained by inverting each bit of the number and adding 
a one in the low order (units) position. 


When an operand must be extended with high-order 
bits, the expansion is achieved by prefixing the field 
with bits equal to the sign bit. That is, positive numbers 
have leading zeros, and negative numbers have leading 
one bits. 


Twos-complement notation does not include a negative 
zero. The maximum positive number is an all-one 
integer with a sign bit of zero. The maximum negative 
number (the negative number with the greatest absolute 
value) is an all-zero integer with a sign bit of one. 


The processor cannot represent the complement of the 
maximum negative number. When an operation, such as 
a subtraction of the maximum negative number from 
zero, attempts to produce the complement of the 
maximum negative number, a binary overflow exception 
occurs. An overflow does not result, however, when the 
maximum negative number is complemented and the 
final result is within the representable range. An 
example of this is a subtraction of the maximum 
negative number from minus one. The product of two 
maximum negative numbers is represented as a 
double-length positive number. 


In discussions of signed binary numbers in this 
document, the expression 16-bit signed integer denotes 
a 15-bit integer with a sign bit (the maximum value is 
+32 767 or -32 768), and 32-bit signed integer denotes 
a 31-bit integer with a sign bit (the maximum value is 
+2 147 483 647 or -2 147 483 648). 
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Address Data 


Address data can have either a 6-byte or 2-byte format. 
The 6-byte format: consists of a 4-byte SID (segment 
identifier) and a 2-byte offset. The SID identifies a 64 
K-byte virtual address area called a segment. The offset 
identifies a 512-byte page within a segment and a 
single-byte location within the page. Base registers are 
used to store address data; operations on address data 
treat the data as unsigned binary values. 


Character Data 

Character data is stored in EBCDIC (extended binary 
coded decimal interchange code) with each character 
occupying an 8-bit byte. 

Character strings are variable in length from 1 byte to a 


maximum of 65 536 bytes. Operations on character 
strings treat the data as unstructured logical quantities. 
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Decimal Data 


Decimal data operands reside in storage and may be in 
either zoned or packed format. IMP instructions are 
provided for adding, subtracting, comparing, multiplying, 
dividing, editing and shifting decimal data in packed 
format only. Conversion instructions may be used to 
convert between packed format and signed binary 
format, between packed and zoned formats, and 
between packed or decimal and long or short 
floating-point formats. 


Decimal Data Formats 


In the zoned format, the rightmost 4 bits of a byte are 
called numeric (N) and normally comprise a code 
representing a decimal digit. The leftmost 4 bits of a 
byte are called zone (Z), except for the rightmost byte of 
the field, where these bits are a sign (S) code. In 
System /38 a zone character is represented as binary 
1111 or hex F. 


In the packed format, each byte contains two decimal 
digits (D), except for the rightmost byte, which contains 
a sign (S) to the right of the decimal digit. The digit and 
sign codes each comprise 4 bits. 
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Zoned Decimal Format 


0 4 8 12 16 20 24 28 32 36 40 4 
Packed Decimal Format 


0 4 8 12 16 20 24 28 32 36 40 4 


Decimal operands occupy fields in storage that start on 
a byte boundary and can be variable in length (1 to 16 
bytes). Decimal operands can overlap if the rightmost 
bytes coincide (the Move Packed Shifted instruction 


allows any overlap). 


Decimal Number Representation 


All decimal numbers are represented as right-aligned 
true integers with plus or minus signs. 


The digits and signs are coded as shown in the 


following chart: 


Binary 
Code 


0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


‘Invalid means this code is not recognized 
as valid for this symbol. 
“The preferred sign code. 


Digit 
Symbol 


OAOnN DOP WN O 


Invalid! 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 


Sign 
Symbol 


Invalid’ 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 
Invalid 
Plus (+) 
Minus (-) 
Plus (+) 
Minus (-)? 
Plus (+) 
Plus (+)? 


4 Bits 


4 Bits 
Digit and Sign Codes 


A data exception occurs with the detection of an invalid 
code. The operation is terminated when the digit code 
is invalid, or suppressed when the sign code is invalid 
(see Chapter 6). 


Although alternate encoding of the sign in an operand is 
accepted, the preferred sign codes are always generated 
for the results of the decimal arithmetic operations. 
Exceptions to this rule are permitted only during decimal 
conversion (CVZP and CVPZ instructions) and editing 
(EDPD instruction). 


Floating-Point Data 


A floating-point number is a bit string characterized by a 
sign, a signed exponent, and a significand. Its value, if 
any, is the signed product of its significand and 2 raised 
to the power of its exponent. The exponent of a 
floating-point number normally signifies the power to 
which 2 is raised in determining the value of the 
represented number. The significand of a floating-point 
number consists of an implicit leading bit to the left of 
its binary point and a fraction field to the right of its 
binary point. 
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Floating-point data has a fixed length, 4-bytes long 
(short format) or 8-bytes long (long format). Both 
formats are designated as operands in storage and must 
be fullword aligned, or a specification exception occurs 
and the operation is suppressed. The formats are as 
follows: 


Short Format 


01 Bits 9 31 


Long Format 


01 Bits 12 





Bits 9-31 


Floating-Point Number Representation 









Bits 12-63 





The floating-point number values that can be 
represented by the short and long floating-point data 
formats include both real and symbolic numbers. 


Real numbers can be represented in either normalized or 
denormalized format. In normalized format, the 
significand for the floating-point number is formed by 
assuming an implicit 1 bit to the left of the binary point 
and concatenating the fraction to the right of the binary 
point. As previously stated, the binary point in either 
format is assumed to be to the immediate left of the 
leftmost bit of the fraction; the fraction is expressed in 
binary digits (bits). 


63 


The significand is multiplied by a power of 2; the 
exponent indicates this power. The exponent field can 
contain a value that can range from O through 255 for 
the short format and 0 through 2047 for the long 
format. The minimum bias value 0 identifies plus or J 
minus O and denormalized numbers, all of which are real 
numbers. The maximum exponent values (255 and 
2047) identify symbolic numbers. The biased exponent 
when adjusted by the appropriate bias (-127 for the 
short format and -1023 for the long format) yields a 
signed (unbiased) exponent. This signed exponent 
specifies the power of 2 which is to be multiplied with 
the significand to produce the magnitude of the 
floating-point number. The sign of the floating-point 
number is either positive or negative, depending on 
whether the sign bit is O or 1 respectively. 


In addition to real numbers, the symbolic.entities of plus 
and minus infinity and a concept of not-a-number 
(NaN) can be represented. 


Infinity is represented by the maximum exponent value 
(255 for short format and 2047 for long format) and a 
fraction of all O bits. Infinity is either positive or 
negative, depending on whether the sign bit is O or 1 
respectively. 





j 


Not-a-number is represented by the maximum exponent 
value and a fraction that contains one or more 1 bits. 
There are two types of NaNs, masked and unmasked, 
with the high-order bit of the fraction indicating the type 
through a value of 1 or O respectively. The fraction 
component of a NaN can have any value other than all 
zeros. These values have no meaning, except that the 
fraction value of a leading 1 bit followed by all zeros is 
the value returned when a masked floating-point invalid 
operand occurs and neither operand is an unmasked 
NaN. Unmasked NaNs, when encountered in a 
floating-point operation, force the detection of the 
floating-point invalid operand condition. Masked NaWNs,, 
when encountered in a floating-point operation, are 
propagated into the result field, but do not force 
detection of the floating-point invalid operand condition. 
A potential usage of these NaN values is to set them 
into uninitialized floating-point fields. This allows the 
detection of a reference to a floating-point field that has 
not been set with a value by the time it is accessed. 


The following information provides a summary of the 
values that can be represented by floating-point data. 
In the following formulas, S = the sign, E = the biased 
exponent or reserved value, and F = the fraction 
components of a floating-point field as previously 
described. Additionally, the ** characters denote 
exponentiation, and the ~ character denotes a logical 
not. 


The values that can be represented in the short format 
are: 


eNormalized number 
(For O<E<255, © 
value = (-1)**S x 2**(E-127) x 1.F) 
e Denormalized number 
(For E=0O & F-=0, 
value = (-1)**S x 2**(-126) x O.F) 
e Signed zero 
(For E=O & F=O, 
value = (-1)**S x 0) 
e Signed infinity 
(For E=255 & F=0, 
value = (-1)**S x infinity) 
e Not-a-number (NaN) 
(For S=O or 1, E=255, F-=0 and with: 
— high-order fraction bit =1; 
value = masked NaN 
— high-order fraction bit = 0; 
value = unmasked NaN) 


The values that can be represented in the long format 
are: 
e Normalized number 
(For O0<E<2047, 
value = (-1)**S x 2**(E-1023) x 1.F) 
e Denormalized number 
(For E=O & F-==0, 
value = (-1)**S x 2**(-1022) x O.F) 
e Signed zero 
(For E=O & F=O, 
value = (-1)**S x 0) 
e Signed infinity 
(For E=2047 & F=0, 
value = (-1)**S x infinity) 
« Not-a-number (NaN) 
(For S=O or 1, E=2047, F= = 0 and with: 
— high-order fraction bit = 1; 
result = masked NaN 
— high-order fraction bit = 0; 
result = unmasked NaN) 


The range covered by the magnitude (M) of a 
floating-point number is: 
« In the short format: 

— Normalized 
2**-126 < M < (2-2**-23) x 2**127 
Denormalized 
2**-149 < M < (1-2**-23) x 2**-126 
e tn the long format: 
Normalized 
2**-1022 < M < (2-2**-52) x 2**1023 
Denormalized 
2**-1074 < M < (1-2**-52) x 2**-1022 
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Short Format (4-bytes) 


Long Format (8-bytes) 


Hex 7F800000 +infinity Hex 7FFOOOOO000U0000 


No representation 


Maximum ((2-2**-23) x 2®*127) 
Hex 7F7FFFFF 


Normalized 


(2**- 126) 
Minimum Hex 00800000 


Maximum ((1-2**-23) x 2**-126) 
Hex 007FFFFF 


Denormalized 


(2**- 1 49) 
Minimum Hex 00000001 





No representation 


(+0) 


Hex 00000000 
(-0) -— 
Hex 80000000 
I 
| 
I 


) 


No representation 


eS 


Maximum -(2**-149) 
Hex 80000001 


Denormalized 


~((1-28*-23) x 2**-126) 
Minimum Hex 807FFFFF 


Maximum -(2**-126) 
Hex 80800000 


Normalized 


-((2-2**-23) x 2**127) 
Minirnum Hex FF7FFFFF 





Nc eore entation 
——————— res 





| No representation 
u 
uJ 
’ 


Maximum ((2-2**-52) x 2**1023) 
Hex 7FEFFFFFFFFFFFFF 


Normalized 


(2**-1022) 


Minimum Hex 0010000000000000 


Maximum ((1-2**-52) x 2**- 1022) 
Hex OOOFFFFFFFFFFFFF 


Denormalized 


((2**-1074) 
Minimum Hex OO00000000000001 


No representation 

(+0 ) 

Hex 0000000000000000 
(-0) 

Hex 8000000000000000 


- 


No representation 


Maximum -(2**- 1074) 
Hex 800000000000000 1 


Denormalized 


-((1-28*-52) x 2**-1022) 
Minimum Hex 8OOFFFFFFFFFFFFF 


Maximum -(2**-1022) 
Hex 8010000000000000 


Normalized 


-((2-2**-52) x 2**1023) 
Minimum Hex FFEFFFFFFFFFFFFF 


No representation 





Hex FF800000 -infinity Hex FFFOOOQOO00000000 
Hex 7FCo0o000 — Masked NaN minimum — Hex 7F F8000000000000 
Hex 7FFFFFFF — Masked NaN maximum — Hex 7FFFFFFFFFFFFFFF 
Hex 7F80001. — Unmasked NaN minimum — Hex 7FF0Q000000000001 


Hex 7FBFFFF. — Unmasked NaN maximum — Hex 7FF7FFFFF: FFFFFF 
Note: Use of sign field bit value of 0 is arbitrary. 





Normalization 


Normalization is performed on intermediate results prior 
to assigning their value to the result field. If the number 
is nonzero, its significand bit becomes 1; the exponent 
is regarded as if its range is unlimited. This produces 
normalized floating-point data for which an implicit 1 bit 
is assumed to be to the immediate left of the binary 
point. If the significant is 0, the number becomes O with 
the sign being set as described under Sign Bit and 
Signed Zero. Normalizing a number does not change its 
sign. 


If a normalized floating-point number has an exponent 

value that is outside the range supported for normalized 
numbers in the destination format, one of the following 
conditions is recognized: 


e A floating-point overflow condition is recognized if 
the exponent is greater than the maximum (127 for 
short and 1023 for long). 


e A floating-point underflow condition is recognized if 
the exponent is less than the minimum (-126 for 
short and -1022 for long) and either the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. 


Floating-point operations for which the floating-point 
underflow condition is detected and masked at the time 
of detection produce denormalized floating-point data in 
the result field. Denormalization is performed on the 
normalized intermediate result by shifting the significand 
right while incrementing the exponent until the exponent 
attains the formats assumed value for denormalized 
numbers (-126 for short and -1022 for long). The 
intermediate denormalized floating-point is then 
represented in the result field by setting the result 
exponent to the minimum value of O and the result 
signed fraction to the value from the significand of the 
intermediate denormalized floating-point number. 
Rounding is performed according to the current rounding 
mode on assignment of the significand value to the 
result fraction. This produces denormalized 
floating-point data for which an implicit O bit is 
assumed to be to the immediate left of the binary point 
and for which an unbiased exponent value of -126 for 
short and -1022 for long is to be assumed. The 
exponent value of 0, which correlates with unbiased 
exponent values of -126 for short and -1022 for long, 
serves as an identifier for denormalized floating-point 
data and is not used to form the true signed exponent 
of the floating-point number represented. The 
underflow exception is signaled only if the result is not 
exact. 


Floating-point fields can only contain real numbers in 
the normalized or denormalized formats. The concept of 
an unnormalized number (one which would allow for a 
variable exponent in conjunction with one or more 
leading O bits prior to the first significant 1 bit) does not 
exist and cannot be represented. 
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Rounding 


All floating-point operations are performed as if to 
infinite precision and then, if necessary, rounded to fit in 
the destination’s format. Four mutually exclusive 
rounding modes are supported: round to nearest, round 
toward zero, round toward positive infinity, and round 
toward negative infinity. The rounding mode bits are 
kept in the TDE (task dispatching element). If y is the 
infinitely precise number that is to be rounded, x is the 
number with the largest representable significand less 
than y, and z is the number with the smallest 
representable significand greater than y (where the 
exponents for x and z may be out of range); then, if y is 
not representable in the destination format (needs 
rounding), the rounding modes change y as follows: 


e« Round to nearest: y is changed to the closer of x or 
z. If they are equally close, the even one (the one 
whose least significant bit is a 0) is chosen. 


e Round toward zero: y is changed to the smaller (in 
magnitude) of x or z. 


e Round toward positive infinity: y is changed to z, 
unless z is negative and its exponent overflows the 
destination’s format. In this case, y becomes the 
format's largest (in magnitude) negative real number. 


¢ Round toward negative infinity: y is changed to x, 
unless x is positive and its exponent overflows the 
destination’s format. In this case, y becomes the 
format's largest positive real number. 


Infinity 
In infinity arithmetic, infinities compare equal regardless 


of sign, and compare unordered with anything else. 
Arithmetic operations on infinity are always exact. 


Sign Bit and Signed O 2 
The sign of a product or a quotient is the exclusive OR 
of the signs of the operands. The sign of a sum or a 
difference differs from, at most, one of the signs of the 
operands following the normal rules of algebra. These 
rules apply even when operands or results are O or 
infinite. The only exception is when the sum of two 
operands with opposite signs (or the difference of two 
operands with like signs) is exactly 0, the sign of that 
sum (or difference) depends on the current rounding 
mode of the process. For round toward negative infinity, 
the sign is minus; for all other rounding modes, the sign 
is plus. 


Exceptions 


The following floating-point exception conditions can be 
detected during floating-point operations: 


Floating-point inexact result 

e Floating-point invalid operand 

¢ Floating-point overflow 

« Floating-point underflow 

e Floating-point zero divide 

« Invalid floating-point conversion 


Associated with these exceptions (except the invalid 
floating-point conversion) is a set of mask and 
occurrence bits in the TDE. 


The mask bit controls the signaling of the exception. If 
the mask bit is 0, the exception is not signaled; if the 
mask bit is 1, the exception is signaled. The mask bit is 
only interrogated for its value. It must be set manually. 


The occurrence bit records the detection of the 
exception condition whether or not the exception is 
masked at the time of detection (1 = occurred; O = has 
not occurred). The occurrence bit must be manually 
reset. 


The definition of these exception conditions and what 


the result of the operation will be when they are 
detected is contained under Exceptions in Chapter 6. 


J 


Internal Microprogramming Objects 


IMP objects are separately addressable units (or 
collections of data) that have associated attributes as 
well as operational characteristics based on these 
attributes. The IMP objects support the tasking and |/O 
structures of the IMP. These objects are used by certain 
IMP instructions (such as Enqueue Message) and must 
begin on fullword main storage boundaries without 
crossing page boundaries (see Data Alignment, in this 
chapter). The IMP objects are: 


e« Task dispatching queue (TDQ) 

e Task dispatching element (TDE) 

« Send/receive queue (SRQ) 

« Send/receive message (SRM) 

¢« Send/receive counter (SRC) 

A characteristic common to all IMP objects is the use of 
the descriptor. The descriptor provides type and control 
information about an |MP object. It is used during 
execution of any IMP instruction that operates on an 
IMP object, to ensure that the operand is valid for the 


operation and to provide additional information about an 
IMP object. 


The descriptor is 2 bytes long. Byte O identifies the type 
of IMP object being described and contains additional 
information, including status information (see the 
following figure). 


Byte 1 of the descriptor is used by the processor to 
monitor accesses to the SRM, SRQ, and TDE IMP 
objects. If the processor detects byte 1 # hex 00 while 
executing an operation that accesses one or more of 
these objects, a descriptor access exception occurs. 


Byte 1 of the TDQ descriptor is ignored. 
When an IMP object is initially creazed, bytes O and 1 
must be appropriately initialized or unpredictable results 


will be encountered. (For more information see Chapter 
5, Tasking.) 
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Descriptor Type—Byte 0, Bit Assignment 












Not valid 


Not valid 


DATA ALIGNMENT 
Data alignment must meet the following requirements: 
« Instructions must begin on halfword boundaries. 


« Halfword storage operands must begin on halfword 
boundaries. 


e Fullword storage operands must begin on fullword 
boundaries. 


e Full addresses (6 bytes) in storage must begin on 
halfword boundaries. 


e Intermediate address fields for certain instructions 
(BALL, CLCL, and MVCL) must begin on fullword 
boundaries and for CLCL and MVCL cannot cross 
page boundaries. 


* Floating-point data (long or short format) must begin 
on fullword boundaries. 






-o | o | 4 |e | Task Dispatching Element 


Send/Receive Queue 


Send/Receive Message 


4 [sam 

| 0 |src__|Send/Recsive Counter 
ars ea 

ps} a fo | |Notvaig 


'Bits 3 through 7 are object dependent and are described in Chapter 5. 





e IMP objects must begin on fullword boundaries and 
cannot cross page boundaries (see the note under 
Send/Receive Message in Chapter 5 for an exception). 


¢« Doubleword alignment is required for certain |/O 
objects (see |/O Addressing Restrictions in Chapter 7), ’ 
some addresses in the control address table (see re 
Assigned Virtual Storage Locations in this chapter), 
and the repetitive interval timer doubleword (see 
Interval Timers in Chapter 9). 


e Space pointers must be quadword aligned. 


e The hash table and primary directory must be aligned 
on an SID (segment identifier) boundary. 


If the aliguament requirements are not met, a 
specification exception occurs. If the system is 
attempting to recover from some malfunction and the 
system encounters an object not in proper alignment, a 
machine check occurs. 





ADDRESSING 


All addresses used by the processor in executing 
instructions or fetching data are virtual addresses. The 
complete virtual address of any byte of storage is 48 
bits containing an SID (segment identifier) and an offset. 
The offset contains a PID (page identifier) and a BID 
(byte identifier). 


Segment Identifier Offset 
0 Bits 32 39 48 


The SID uniquely identifies a 64 K-byte virtual address 
area called a segment. The entire virtual storage of the 
VMC can be considered a collection of nonoverlapping 
segments. 


The offset identifies a 512-byte page within a segment 
and a single-byte location within the page. Therefore, it 
provides for relative addressing of up to 65 535 bytes 
beyond the location designated by the SID. 


Storage operand addressing is achieved by adding a 
displacement to a base register identified by the 
instruction. The displacement is a 12-bit field also 
found in the instruction. 


Address translation uses the VAT (virtual address 
translator) facilities described in Chapter 8. These 
facilities include: 


e Hash Table—a list of entries used to index the primary 
directory. 


e Primary Directory—a table of the virtual addresses of 
a page. The table also provides status information 
about the page. 


e Lookaside Buffer—a high-speed buffer storage that 
contains some of the information specified in the PD 
(primary directory). The translation process is 
shortened if the virtual address referred to is currently 
listed in the LB (lookaside buffer). 





The following virtual addresses are called virtual = real 
addresses and do not use the VAT facilities. Virtual = 

real addresses are invalid if they exceed the amount of 
real storage configured for the processor. 


Virtual = Real Address 


Segments 
of Real 
Storage 
Addressed 


Segment Identifier (SID) 
Values 


3, 4, and | 0000 0100 through 0000 First 32 
Ss) 011F 


6, 7, and |Q000 0100 through 0000 
8 O1FF 


First 256 


Eight system control instructions are used to verify a 
virtual address and maintain the VAT facilities. These 
instructions are HVVA, IPDE, RRCRR, LPDEA, LHTEA, 
LPDEAR, EPDE, and RPDE. 


Virtual address overflow protection is only on segment 
boundaries. When an offset attempts to overflow into 
the next SID, either the SID is incremented by 1 or an 
effective address overflow exception occurs. Which of 
these two events occurs is determined by the instruction 
involved, the model, the level of horizontal microcode, 
and the hardware. If a carry out of bit 24 occurs when 
adding 1 to the high-order 32 bits of a storage address, 
an effective address overflow occurs. 
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Instructions 


Each instruction consists of two major parts: an op 
(operation) code and one or more operands. 


e The operation code specifies the operation to be 
performed. 


e« The operands designate the data or address of data 
for the operation. 


In addition, certain instructions may contain operand 
lengths, masks, or other control information needed to 
perform the specified operation. 


OPERATION CODES 


The operation code for an IMP instruction consists of an 
8-bit code that is unique to either one instruction or to a 
set of instructions that use a unique operation code 
extender. The operation code occupies the first byte of 
the instruction. Appendix C shows the operation code 
assignments. 


Operation 
Code 


OPERANDS 


Operands can be grouped in three classes and can be 
either explicitly or implicitly designated. The classes are: 


« S (storage operands)—located in real storage 


« R (register operands)—located in registers (internal 
storage) 


e | (immediate operands)-located in the instruction 
itself 





implied by the operation code, be specified by a bit 
mask, be explicitly provided by a register, or be 
specified by a 4-, 8-, or 16-bit L (length) field 
contained in the instruction or operand. 


The length of an operand in storage can either be ) 


For explicitly stated variable length operands, the length 
code in the L field specifies the number of additional 
bytes to the right of the byte designated by the storage 
operand address. Therefore, the length in bytes is one 
more than the value of the L field. 


The addresses of operands in storage are specified by 
means of a format that uses the contents of a B (base) 
register as part of the address. This makes it possible 
to: 


e Specify a complete address by using an abbreviated 
notation. 


e Perform address manipulation using instructions that 
use base registers for operands. 


« Modify addresses by program means without 
alteration of the instruction stream. 


e Operate independently of the locations of data areas ) 
by directly using addresses received from other \ 
programs. 


The address used to refer to storage is contained in a 
register designated by the B field in the instruction, or is 
calculated from a base address and displacement 
designated by the B and D (displacement) fields in the 
instruction. 


Register operands are located in registers identified in a 
4-bit field in the instruction. 


Immediate operands are contained within the instruction 
in a half-byte, byte, or halfword | (immediate) field. 


To describe the execution of instructions, storage 
operands are designated as first and second (and in 
some cases, third) operands. 


In general, two operands participate in the execution of 

an instruction. The result replaces the first operand. 

Except for storing the final result, the contents of all 

registers and storage locations participating in the 

addressing or execution of an operation for most 

instructions remain unchanged. A few instructions (such 

as TRT) also modify operands other than the final result. J 





C 


Operand referencing is summarized in Figure 2-1. This 
figure shows the use of storage, immediate, and register 
operands. 


A 
8 


Operation Code 

Number of a halfword register (hex value), 
R(O)—R(F). 

Number of a 1-byte register (hex value), 
r(O)-r(F); or a 4-bit operation code extension 
field, E 

Immediate operand 


Number of a base register (hex value), B(O)—B(F) 
B(n) = S(n) concatenated to R(n), where n is a 
value of hex O to F 

A 12-bit displacement added to the base 
register 

Storage operand addressed by B + D 

Length of the storage operand in bytes, minus 
one 


Note: The format used here does not represent an 
actual instruction. It does, however, illustrate the use of 
actual fields. 


4 Bytes 2 Bytes 


s0 | 


ol 





Figure 2-1. IMP Operand Reference 


I: 


R(0O) 


1Byte 1 Byte 


r(0) r(1) 
@; (6) | oF) 
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FORMATS AND EXAMPLES 


An instruction is 1, 2, or 3 halfwords in length. Each 
instruction must be aligned on a halfword storage 
boundary and cannot cross a segment boundary. The 
basic instruction formats are shown in the following 
figure. The format of an instruction is dictated by the 
type of operation to be performed. In the figure, the 
bytes in each format are labeled with letters that 
indicate the use for each byte. The use of the bits 
within a given format can vary from instruction to 
instruction. 


Basic IMP Formats 


All IMP instructions fall within one of the following 
categories. Within each category, some instructions 
differ slightly from the basic format shown: 


RR (register to register) — 2 Bytes 

Code 

RI (register and immediate) — 4 Bytes 
Operation 

Code 2 

RS (register to storage) — 4 Bytes 

Operation 

Code By D 

SI (storage and immediate) — 4 Bytes 
Operationk— |, 

Code E D 

SI (storage and immediate) — 6 Bytes 
Operation L _ 
Code E : : 
SS (storage to storage) — 6 Bytes 


Operation 


Legend? 


, e 


Base register 

Displacement 

Operation code extension field 
immediate 

Jump displacement! 

Length 

Mask' 

Halfword register 

One-byte register’ 


7" yme2re-mow 


‘Symbols not shown in the examples above are used in the 
formats in Chapter 10. 

2Subscript numbers that appear with these letters designate 
the operand number. 


Note: A field left blank in the instruction format 
diagram may contain random values that are not 
important to the execution of the instruction; the same 
field is represented in the instruction example with the 
placeholder O. 


) 





> 


C 


ADDRESS GENERATION 


The storage address can be contained in a register 
designated by the B (base register) field in the 
instruction or calculated from a B and a D 
(displacement) field in the instruction. 


The base address is a 48-bit number contained in a 
base register specified by the 4-bit B field of the 
instruction. A base address can be used as a means of 
independently addressing each program and data area. 
In array-type calculations, it can specify the location of 


an array. In record processing, it can identify the record. 


In forming the storage address, the 16-bit offset (page 
and byte identifiers) portion of the base register and the 
12-bit displacement field of the instruction are added as 
unsigned binary integers. The sum is always 16 bits 
long and is logically appended on the right to the 
high-order 32 bits of the base address. When an 
overflow occurs, either the high-order 32 bits of the 
storage address are incremented by one or an effective 
address overflow exception occurs. Which of these 
events occurs depends upon the particular instruction 
involved, the model and the engineering level of the 
horizontal microcode, and the engineering level of the 
hardware. If, in adding 1 to the high-order 32 bits of 
the storage address, a carry occurs from bit 24, an 
effective address overflow exception occurs. 


A zero on the R (2-byte register), B (base register), or D 
(displacement) fields has no special significance except 
to denote the use of register zero or a zero 
displacement. 


An instruction can designate the same base register 
both for address computation and location of an 
operand. Address computation is completed prior to the 
execution of the operation. 


Unless otherwise indicated in the individual instruction 
definition, the computed operand address designates an 
operand in storage. When a storage operand is 
designated, the address points to the leftmost byte of 
the operand. 


To find the effective address of a storage operand, first 
use the B field of the instruction to locate the base 
register; then add the contents of the base register and 
the contents of the D field of the instruction (see Figure 
2-1) as follows: 


Effective Address = Contents of Base Register + 
12-bit displacement 


EXECUTION 


The IAR (instruction address register) contains a 2-byte 
offset into the segment identified by the SID (segment 
identifier) contained in register S(O). In program 
execution, the next instruction is fetched from the 
location designated by the IAR. The instruction address 
is then increased by the number of bytes in the 
instruction in order to address the next instruction in 
sequence. The instruction is then executed, and the 
same steps are repeated using the new value of the 
instruction address. 


The normal sequential execution of instructions can be 
changed by: 


e The use of branching instructions to perform 
subroutine linkage, decision making, and loop control. 


e Conditions arising during program execution that 
cause linkage to an exception-handling routine. 


e Conditions arising external to the currently executing 
program. Such conditions can cause interruption of 
processing, the storing of information describing the 
current program, and the invocation of another 
program that is part of the task whose condition 
caused the interruption. 


Conceptually, the processor processes one instruction at 
a time, executes instructions sequentially, executes the 
instruction specified by the branch address following the 
successful execution of the branch, and allows interrupts 
to take place between the execution of instructions. 
Physical storage width and overlap of instruction 
execution with storage accessing may cause actual 
processing to differ from this concept. Each operation is 
performed sequentially with the next instruction being 
prefetched before the current operation is completed. 
Modification of succeeding instructions while using 
prefetch will produce unpredictable results. 


It can be assumed that the execution of each instruction 
occurs as an indivisible event. However, in actual 
operation, the execution of an instruction can consist of 
a series of discrete steps. Depending on the instruction, 
operands can be fetched and stored in a piecemeal 
fashion, and some delay can occur between fetching 
and storing a result. 


Programming Note: Because of a hardware restriction 


the last fullword of a segment on Models 3, 4, and 5 
should not contain an instruction. 
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BRANCHING 


A branch instruction (ALHBL, BC, BCN, BCNX, BCT, 
BU, TMBIBO, and TMBIBZ) is used for branching within 
the instruction stream that contains the branch 
instruction. The halfword displacement in the instruction 
(or pointed to by the instruction) is added to the 
contents of register R(O), and the result replaces the IAR 
(instruction address register). 


The address in registers S(O) and R(O) must always point 
to the start of the instruction stream because all 
branching is done relative to this address. 


The Branch Internal (BI) instruction is used for branching 
within the current segment group. 


A jump instruction (JBN, JBF, and JC) works relative to 
the IAR. A 1-byte displacement is added to the 2-byte 
IAR to form the address of the next instruction. 


A linkage instruction (BAL, BR, BALL, BRL, and CALLI) 
provides a mechanism to do a branch and link and a 
return. BAL (Branch and Link) and BR (Branch Register) 
instructions provide linkage to instructions in the same 
segment. BALL (Branch and Link Long) and BRL 
(Branch Register Long) provide linkage to instructions in 
a different segment. 


Programming Note: The extended mnemonics used by 
the IMP instruction assembler for the BC, BU, and JC 
instructions are listed with their respective instruction 
descriptions. 


CONDITION CODES 


Facilities for decision making are provided by the branch 
instructions. A 4-bit condition code reflects the results 
of most of the arithmetic, logical, and other manipulation 
and control instructions. Each of these operations can 
set (and reset) bits of the condition code and the 
branching instructions can specify (by masking) any 
selection of the bits as the criterion for branching. (See 
Chapter 10, Instruction Descriptions for the specific 
condition code settings.) 


SUPERVISOR LINKAGE 


The normal sequential execution of instructions can be 
changed by conditions arising during program execution. 
The IMP SVL (supervisor linkage) provides a trapping 
mechanism to handle these interruptions. 


The SVL instructions have the following format: 










16 20 32 36 









Bits 


Explicit 


f- 


Implicit 


For explicit SVLs, the second byte of the SVL instruction 
is used as an index into a main storage area called an 
SVL table. For implicit SVLs, the operation code acts as 
an index into the SVL table. 





Each entry in the SVL table contains the number of 
registers to be stored, the address of the procedure to 
which control is passed, and other descriptive and . 
control information. 


Whenever the processor passes control via an SVL it 
automatically saves certain designated machine facilities 
such as the IAR (instruction address register), exception 
code, and condition code values. In addition, it 
optionally saves base registers. These facilities are 
saved in a special list element known as the CRE 
(call/return element). 


See Chapter 6 for a description of the SVL facilities. 





PROGRAM EXCEPTIONS AND INSTRUCTION 
LENGTH COUNT SETTINGS 


Exceptions that result from the execution of instructions 
are called program exceptions. The SVL (supervisor 
linkage) mechanism is used to indicate exceptions. The 
first entry of the SVL table is the implicit index value 
associated with program exceptions. 


For a more detailed explanation of exceptions and 
exception codes, see Call/Return Element and Exceptions 
in Chapter 6. 


Concurrent Exceptions and Causes 


[Excoption (Causes instruction Is 
Soft address aaa Main store address compare when in address ota panier pon =e mode. or aay (Note 1) 


iaekGhteeval tie... interval timer Task interval timer Fas iitanal tmarespiedduingatmediads | during a timed task. Nullfied | 


Monitored ACQ (available | An exception SVL detected a monitored ACQ (header byte 1 # Note 2 
call/return element queue) | hex OO) during an implicit CRE receive. 


Monitored CRE A monitored CRE (byte 1 # hex 00) was detected, due to an 

(call/return element) implicit receive by an exception SVL. 

Monitored TDE (task No available CREs exist for an implicit receive by an exception Note 2 
dispatching element) SVL, and the current TDE is monitored (byte 1 # hex OO). 

Note 1: A soft address compare exception during an instruction stream fetch nullifies the instruction. 
Note 2: The instruction termination state is determined by the concurrent program exception condition. 
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Program Exceptions and Causes 


Hex 
Code | Exceptions 


Causes Fama 
oo No exception | 
‘on Invalid Descriptor Invalid field encountered during operation on IMP object. 


Allocate Page Frame 


Monitored Descriptor 
SRO 

















SRO (send/receive queue) busy. Nullified 


1. 
2. Hold/Free Chain busy. Nullified 













OU task requests page frame to be allocated and cleared in main Nullified 


storage. 


SRQ (send/receive queue) access attempted when its byte 1 is Suspended 
nonzero. 
SRM (send/receive message) access attempted when its byte 1 is Suspended 
nonzero. 








OA 


Oo 
2) 


Monitored Descriptor 
SRM 


Monitored Descriptor | TDE (task dispatching element) access attempted when its byte 1 is | Suspended 
TDE nonzero. 


Send/Receive Counter|A carry from the high-order position of the count field occurred Terminated 
Overflow during a send operation. 
















Address Translation Unable to translate a virtual to a real address by using VAT. For 


GHRF, GHR, FHRF, and FHR instructions, the instruction is 
completed and condition code 3 is set if exception occurs on hold 
record chain. 


Nullified 


Nullified 
Completed 


Subject of EX instruction is another EX instruction Suppressed 


Specification 1. Improper alignment Suppressed 
(see note) 2. Other conditions (see Specification Exception in Chapter 6). Suppressed 
1A 


Addressing 


Programming Event An instruction is executed in a defined address range. 
1. If not masked (bit 8 of TDE exception mask field is set) 


2. 











If masked (bit 8 of TDE exception mask field is reset) 






Invalid virtual = real instruction address. Suppressed 


1 
2 


1C Effective Address 1. Offset overflow during effective address calculation. Suppressed 
Overflow 2. Storage operand crossed segment boundary. Suppressed 





Invalid virtual = real operand address. Terminated 













12 Invalid decimal sign code. Suppressed 
2. Invalid decimal digit code. Terminated 
Insufficient left zeros in multiplicand (MP). Terminated 


Note: All instructions are tested for this exception. 








Program Exceptions and Causes (continued) 


Hex 
Code | Exceptions Causes 


a Binary Overflow 


22 |oieen Omiie Divide 









ii Carry from sign bit and carry from high-order numeric bit Completed 
disagree. 
2. Result exceeds 31 bits (CVPB). Completed 


3. 





Significant bits are lost (SLA). Completed 


Quotient exceeds the size of the result field or an attempt to divide 
Bnery Dhide [a zero. 


= Decimal Overflow Destination field is too small for the result. Completed 
26 Decimal Zero Divide _| An attempt to divide by zero. Suppressed 


Suppressed 


Floating-Point Resultant exponent is too large. Completed 
Overflow 


Floating-Point Resultant exponent is too small. 
Underflow 


Floating-Point Inexact | Rounded result is not exact. 
Result 


Floating-Point Zero An attempt to divide by a number with a zero fraction. Suppressed 
Divide if not 
masked; 


Completed 










Completed 








Completed if 
masked 


30 Operation (see note) | Invalid operation code Suppressed 


; Stack entry to be removed during unstack has flag bit 15 (first | Suppressed 
entry in segment) set. 

: Stack operation adds entry that extends beyond stack limit Suppressed 
value. 








x vety 


> Chain Conflict 
a End-of-Chain 


Edit Digit Count 


A verify exception occurs when an LVT, AHSPOI, AHSPO, or AFSPO 
a4 venty | erty detects an invalid operand. 






Suppressed 
Nullified 
Nullified 


Empty chain on free operation. Nullified 
End of available chain on hold operation. Nullified 
No matching hold on free operation. Nullified 


Conflict on an object hold operation. 
Object free operation attempted to free a monitored hold. 





End-of-source field was reached and there are more control Terminated 
characters corresponding to digits in edit-mask field than in 
source field. 


End-of-edit-mask field was reached and there are more digit | Terminated 
positions in the source field. 








Note: All instructions are tested for this exception. 
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Program Exceptions and Causes (continued) 


Hex 
Code | Exceptions Causes 
3C 1. 


Length Conformance More character positions in result than in edit-mask field 





Instruction 
Is 





















Terminated 












(EDPD). 

2. More character positions in edit-mask field than in result field | Terminated 
(EDPD). 

3. Incorrect number of hex B2's following a hex B1 (floating Terminated 


string) field in the edit mask (EDPD). 


4. The converted form of the source record is larger than the 
result record length (CVTMC). 









Terminated 











Invalid control characters in edit-mask field. Terminated 






Edit Mask Syntax 


Invalid Segment 1. Leftmost 3 bytes of virtual address are invalid. 






End-of-string character field termination missing. Terminated 







Suppressed 
Suppressed 
Suppressed 





Group Address 2. Address below lower boundary address. 
Overflow generated in calculation of 3-byte address. 











Suppressed if 
not masked; 

Completed if 
masked 


Floating-Point Invalid | An operand or operation is invalid. 
Operand 


Reserved ee 


Second Chain Search |A Grand Hold or Free Hold instruction has determined that a 
secondary chain must be searched. 
at rr ee 


1. Data length in string control byte is zero for CVTMC or CVTSC | Terminated 
instruction. 











Nullified 





47 


Conversion 


The end of source is encountered before the end of a Terminated 


compression string in CVTSC. 


A compression string describes a character string which would | Terminated 
cross a record boundary in the receiver.CVTSC. 


When overflow, infinity, or not-a-number precludes accurate Suppressed 
representation in binary format. 


Invalid Segment . Operand addresses are not within the same segment group. Suppressed 





4A Invalid Floating-Point 


Conversion 


4C-7F | Reserved 





Segment or segment group specified by first operand does not | Suppressed 
exist. 








Program Exceptions and Causes (continued) 


Hex 
Code | Exceptions 
Invalid Page Segment group size was less than 16 megabytes and a reference Suppressed 
was made to an address that would have been valid if segment had 
been larger (PPR). 


om Page Read Error Permanent |/O error while reading page from auxiliary storage. 
'33 | Invalid Pool State Too many pages pinned to perform bring or clear with pin (PPR). Suppressed 


Invalid Pin Request Attempted pin was 256th pin for same page. Suspended 
Unpin attempted on unpinned page. 
g5 Invalid Write Request | Write requested to a pinned page. 


86- Bad Main Storage Changed data in main storage could not be accessed due to a Terminated 
SF Page Frame memory failure. 
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The cause of the exception is identified in the exception 
code field of a CRE (call/return element). See Chapter 6 
for the bit assignment of this field. 


The ILC (instruction length count) is a 3-bit code that 
provides the length of the last instruction executed. The 
ILC permits identifying the instruction causing the 
exception when the IAR (instruction address register) 
designates the next sequential instruction. The value of 
the ILC indicates the number of bytes that the IAR has 
been incremented. The status field of a CRE or a TDE 
(task dispatching element) contains the ILC after an 
exception has occurred. 


Program exceptions are treated according to the cause. 
The instruction being executed at the time of the 
exception is handled in one of the following ways: 


e Completed-the instruction is allowed to continue to 
completion with predictable results and the IAR is 
advanced to the next instruction address. The ILC 
indicates the length of the completed instruction. 


e Terminated—the instruction is terminated at the point 
of the exception with unpredictable results and the 
IAR is advanced to the next instruction address. The 
ILC indicates the length of the terminated instruction. 
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Suppressed-the instruction is not allowed to continue 
and the IAR is advanced to the next instruction 
address. The result fields are not changed. The ILC 
indicates the length of the suppressed instruction. 


Nullified—the instruction is stopped with the IAR not 
advanced to the next instruction address. The ILC is 
set to zero. 


Suspended-the instruction is stopped at the point of 
the exception and checkpoint data is stored in a 
reserved area. So that the operation can be resumed 


at the point of the exception, the IAR is not advanced 


to the next instruction address. The ILC is set to 
zero. 


J 


Permanent Storage Assignments 


CONTROL ADDRESS TABLE 


To execute the IMP tasks, the location of certain control 
information must be known to the processor. This 
information includes all of the system-known queue 
headers, the addresses of the system exception handling 
routines, and the storage management parameters 
including the storage page tables. This control 
information is located in the segment at hex OOOO 0100, 
beginning at offset hex OOOO. 


ASSIGNED VIRTUAL STORAGE LOCATIONS 


The control address table entries are shown in Figure 
2-2. Those entries that have not already been described 
are covered in subsequent chapters. 


The addresses are right aligned on doubleword 
boundaries for ease of indexing by the processor. The 
objects pointed to by the addresses in the table (except 
for the Function Routine Address Table or the first 
available hold record, neither of which references 
resident data) must be resident in main storage and 
properly aligned; otherwise a machine check occurs. An 
improper alignment of that object causes a program 
specification exception. 


The leftmost 2 bytes of each table entry are reserved, 
and except where specified, must be set to zero. 
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Byte /|Use Virtual = 
(Hex) | Code' | Real Address Of 
Pee 
Hash, table address and the number of entries-1 in the leftmost 2 bytes? 


ee 
20 _|a [No __| 1/0 event stack (must be pinned and V=V) 
so | | Reseed 
38__|b __|ves__| Machine check log buffer 
40 |b |Yes Machine check handler 


aa fe yes Current TDE (task dispatching element) or previous TDE when the processor is in the 
wait state 


50 [a [No | Prime TDA ttask dispatching queue) 
Reseed 
60 |b [No | Sv (supervisory linkage) table 
68 |b [No | ACA (available CRE queue) 
fb [No 
bp No 





Main store defective frame table (If an alternate IMPL is performed, the length of the 
overlay area [in bytes] is placed in the high-order [leftmost] 2 bytes for use by 
Service Monitor 1; otherwise, the high-order 2 bytes are unused.) 
























HMC overlay area (If an alternate IMPL is performed, the length of the overlay area 
(in bytes) is placed in the high-order (leftmost) 2 bytes for use by Service Monitor 1; 
otherwise, the high-order 2 bytes are unused.) 





a. sa. 
fas [a [ves [Hash table for hold/free instructions 
90 |e [No | First available hold record for hold/free instructions 
98 |b [No | Task switch trace table (must be pinned VV) 
jao |b [No | FRAT (function routine address table) 
as ib [No [instruction address sampler control block 


‘Use codes: 
a. Loaded into the processor at IPL (initial program load) or IMPL (initial microprocessor program load) time. 
b. Referenced by the processor whenever an address is needed by HMC (horizontal microcode). 

c. Altered by the processor as required. 

d. Loaded and used at IMPL time. 

Programming note: The number of entries in the hash table must be a power of two. 

3The use code is a for Models A and C and D for all other models. 


Figure 2-2. Assigned Virtual Storage Locations 


The continuation of the control address table (MCA, 
machine communications area) is described in the 
Vertical Microcode Data Areas manual. 
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Chapter 3. Horizontal Microcode Support Functions 


Horizontal Microcode Procedures 


An HMC (horizontal microcode) procedure has many of 
the characteristics of an IMP (internal 
microprogramming) procedure in that it uses the IMP 
facilities and operates on operands in storage. It is 
different in that the horizontal microcode instructions 
execute directly on the processor hardware and are 
addressed by the CSAR (control store address register) 
rather than the IAR (instruction address register). 


HMC procedures, the primary communications device in 
the OU (operational unit) tasks (see Chapter 7), perform 
built-in processor functions that support the IMP. These 
procedures provide a highly developed yet controlled 
operation to enhance the performance of the processor. 
HMC procedure functions are distinguished in this 
manual from the processor built-in functions as follows: 


e HMC procedures can incur page faults and other IMP 
exceptions; processor built-in functions cannot incur 
page faults and other IMP exceptions. 


e HMC procedures compete with IMP procedures and 
other HMC procedures for system resources via the 
task dispatching structure; processor built-in 
functions execute immediately (on the next IMP 
instruction boundary or interruptible point if the 
instruction is interruptible) when invoked. 


An HMC procedure can use the same processor built-in 
functions that are invoked by an IMP procedure via an 
IMP instruction. An example of this could be a particular 
queueing (causing to wait) function that is invoked via 
an IMP instruction as well as an HMC procedure. When 
done via an IMP instruction, this is referred to as an 
explicit invocation. When done via an HMC procedure, it 
is referred to as an implicit invocation. While executing 
an HMC built-in procedure or function, no IMP 
instructions are executed. That function is accomplished 
below the IMP interface. 


The IMP processor can also remain idle while waiting 
for work; in this condition, no dispatchable task exists. 


Transfer of control from an HMC procedure via the SVL 


(supervisor linkage) mechanism is performed only for 
exceptions. 
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Horizontal Microcode Built-In Functions 


A built-in function consists of processor operations that 
have the following attributes: 


e If page faults or other exceptions are detected during 
execution, a machine check occurs. (See Chapter 9 
for a description of machine check handling.) 


e Built-in functions are not associated with any task. 


¢ Built-in functions are not implemented by IMP 
procedures. 


Built-in functions include: 
« |/O event handler (see Chapter 4 for a description) 
¢« Task dispatcher (see Chapter 5 for a description) 


e Clock comparator and interval timer event signaling 
(see Chapter 9 for a description) 


e« Exception handler 

e Machine check handler 

Built-in functions can be invoked by: 
e IMP instructions 

e HMC procedures 

e Other built-in functions 


e Asynchronous events 


TASK DISPATCHING 


The execution of procedures by the processor is 
controlled by the tasking structure. Each |MP task is 
represented by an IMP object called a TDE (task 
dispatching element). A task then may be thought of as 
a unit of executabie work and is composed of one or 
more procedures that are synchronously executed to 
perform that unit of work. 


Since any task may have to wait periodically (for 
example, due to |/O requests or page faults), provisions 
are made for multiple tasks to compete for the 
resources of the processor, each task being represented 
by a TDE. 
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The TDEs representing dispatchable tasks (those tasks 
not waiting for the completion of some operation) are 
enqueued in priority sequence on a chained list known 
as the TDO (task dispatching queue), which is also an 
IMP object. 


To initiate processing, a built-in function known as the 
task dispatcher is invoked. The task dispatcher accesses 
the TDQ and selects the first TDE on the list as the task 
to begin executing. 


For other than the current task, the TDE contains the 
current state of a task (IAR, condition code, base 
registers, and so forth). Therefore, the dispatcher 
accesses the TDE from which the processor is loaded to 
begin executing the current procedure of that task. This 
task is then referred to as the current or active task. 


Conversely, the task dispatcher may place the active 
task in the inactive state by reversing the previous 
process. That is, the state of an active task is stored in 
its TDE. The loading and storing of the state of an IMP 
task is illustrated in the following figure: 






| VMC Processor 


2 


Chapter 4. The Processor 


The processor is the control center of the machine. It 
contains the sequencing and processing controls for 
instruction execution, tasking and exception handling, 
timing facilities, initial program loading, and other 
machine related functions. 


The processor can process binary integers (in fixed or 
variable length), floating-point numbers, decimal 
integers of variable length, and logical information in 
fixed or variable lengths. 


The processor can reference and change virtual 
addresses (see Operands in Chapter 2) in the 16 base 
registers. These registers are designated by a 4-bit B 
(base register) field in an instruction. Some instructions 
provide for addressing multiple base registers by having 
more than one B field. 
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Processor States 


When machine power is on, the processor is in either 
the operational state or the stopped state. 


OPERATIONAL STATE 


The operational state is the normal execution state of 
the processor. In this state, instruction execution can 
proceed, built-in functions are enabled, timers are 
operational, and the |/O channel facilities are active. 


Within the operational state, the processor may be 
either in the run state or in the wait state. 


When the processor is in the run state, it is executing 
either an IMP (internal microprogramming) procedure, an 
HMC (horizontal microcode) procedure, or a built-in 
function. Conversely, when the processor is in the wait 
state, there are no tasks that are dispatchable. 


An IMP task is dispatchable only if its TDE (task 
dispatching element) is enqueued to the TDQ (task 
dispatching queue). 


Note: A task is not dispatchable if its TDE is enqueued 
to the wait list of an SRO (send/receive queue) or SRC 
(send/receive counter). In this case, the TDE is said to 
be inactive and waiting. 


The processor is placed in the wait state by the task 
dispatcher as the result of a task switch when the TDQ 
contains no TDEs. In this state, the processor is waiting 
for additional work. 


Note: The processor is removed from the wait state 
either as the result of a built-in function issuing an 
implicit send operation that causes a TDE to be moved 
to the TDQ or as the result of a machine check. 
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STOPPED STATE 


The processor can be put into three different stopped 
states: 


e Processor stop 
« Microprocessor stop 
« Check stop 


The processor can be put into the processor stopped 
state through the machine console. In the processor 
stopped state, no IMP instructions are executed and the 
interval timers are not updated. The time-of-day clock 
and the clock comparator are still operational. Events 
from |/O, timers, and SCA (system control adapter) are 
still handled. 


The processor can be put into the microprocessor 
stopped state through the machine console. In this 
state, no HMC or IMP instructions are executed. The 
interval timers, time-of-day clock, and clock comparator 
are not updated, and exceptions from |/O and timers 
are not handled. 


The processor can be put into the check stopped state 
via one of the following mechanisms: 


e The built-in HMC machine-check function determines 
that a terminating machine check has occurred. 


« The processor hardware encounters a terminating 
machine check. 


« A VMC procedure issues a Terminate Immediately 
instruction while in machine-~check mode. 


The check-stopped state is a special form of the 
microprocessor stopped state that normally requires an 
IMPL (initial microprogram load) operation in order to 
restart the processor (see Check Stop in Chapter 9 for 
further information). 


Input/Output and Asynchronous Events 


In IMP, all 1/O operations and communications with 
asynchronous processing run concurrently with task 
execution, and are handled as intertask exchanges of 
messages on queues. |/O devices, external processors, 
and asynchronous operations appear to have 
characteristics similar to an IMP task. Rather than 
interrupting IMP processing to signal an event or 
condition, |/O devices and asynchronous events are 
handled by the |/O event handler and the OU 
(operational unit) task. 


QUEUE INTERFACE 


All 1/O operations are handled by a queuing structure. 
An IMP task, in control of an 1/O operation, sends a 
command to an OU command queue used as input to 
an OU task. After command execution, the OU task 
sends the command response to the IMP task. The IMP 
task (for example, IOM) completes the |/O processing 
cycle when it accepts the response. 


I/O EVENT HANDLER, OPERATIONAL UNIT TASK, 
AND 1/0 DEVICES 


The I/O event handler and the OU task connect tasks 
executing in the processor with |/O devices. The OU 
task directs the flow of information between main 
storage and |/O devices, relieves the processor of 
communicating directly with the devices, and lets IMP 
task execution proceed concurrently with |/O 
operations. |/O devices include card readers and 
punches, magnetic tape units, disk storage, 
printer-keyboard devices, printers, and teleprocessing 
equipment. 


|/O device operation can be handled by a control unit. 
The control unit can be an integral part of the i/O 
device attachment or an external unit. The control unit 
provides the logic and buffering necessary to operate its 
|/O device. From a programming view, control unit 
functions merge with |/O unit functions. Other |/O 
device operations are controlled by hardware adapters. 
The processor and storage use the channel as an 
interface to |/O devices and their control units. The 
channel directs the flow of data between |/O devices 
and storage (for details of the channel interface, see 
IMP Channel Objects in Chapter 7). 


SYSTEM CONSOLE 


The system console is used to operate the machine. 
The console consists of an operator/service panel, a 
display, and a keyboard. 


The operator/service panel indicates system status and 
provides the operator with controls to intervene in 
normal programmed operations. The display and 
keyboard allow the operator to communicate with 
supervisory and problem programs. (See System Control 
in Chapter 9 for a list of the system console functions.) 
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This chapter describes the structures and operations of 
the tasking functions used by the processor. 


IMP (internal microprogramming) tasking is the process 
of controlling the execution of IMP tasks. An IMP task 
is characterized by the synchronous execution of one or 
more IMP procedures. An IMP procedure is composed 
of an IMP instruction stream, the data used by the 
instruction stream, and the parameters and arguments 
used to pass information between IMP procedures. 


PROCEDURE EXECUTION 


At any time, the status of the processor is one of the 
following: 


e Executing an IMP instruction in an IMP procedure 


e Executing an HMC (horizontal microcode) built-in 
function 


e Executing an HMC instruction in an HMC procedure 
¢ Idle (waiting for additional work) 


An IMP procedure is executed in the environment of an 
IMP task. The primary control structure of an IMP task 
is the TDE (task dispatching element). While executing 
an IMP procedure, IMP instructions are fetched 
sequentially by the processor from the storage location 
addressed by SID (segment identifier) register O plus the 
2-byte IAR (instruction address register). As each 
instruction is fetched, the IAR is incremented by the 
number of bytes in that instruction so as to address the 
next instruction. The current instruction is then 
executed, and the same steps are repeated, using the 
new IAR value. Sequential execution of instructions 
within the current procedure can be changed by 
branching within the procedure or by causing a transfer 
of control to another procedure. If control is transferred 
to a new procedure, the new procedure can execute 
under the same task (as with a supervisor linkage 
operation) or can execute under a different task (as with 
a task switching operation). In addition, control can be 
transferred to a new procedure in any of the following 
ways: 
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e The current IMP procedure specifies an implicit or 
explicit SVL (supervisor linkage) instruction (see 
Supervisor Linkage in Chapter 6). 


e A program exception occurs causing a built-in 
processor function (see Horizontal Microcode Built-In 
Functions in Chapter 3) to pass control to the IMP 
exception handling procedure. The processor passes 
contro] to the IMP exception handling procedure via a 
special invocation of the SVL function termed the 
exception SVL function (see Supervisor Linkage in 
Chapter 6). 


« The current IMP procedure issues a send or receive 
instruction and a task switch occurs. 


- An 1/O or timer event occurs causing a task switch. 
e A machine check occurs causing control to be passed 
to the IMP machine check handler (see Machine 


Check Handling in Chapter 9). 


No IMP instructions are executed during the execution 
of an HMC procedure or built-in function. 


The processor can also be in an idle condition waiting 
for work. In this condition, no dispatchable task exists. 
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BASE REGISTER ASSIGNMENTS 


There are 16 base registers that can contain addresses 
during IMP procedure execution (see Register 
Descriptions in Chapter 2). 


Base register O points to the start of the instruction 
stream. All instruction addressing and branching within 
a procedure is relative to B(Q). Base registers hex 1, 2, 
and E, and byte register hex E are designated to receive 
parameters during explicit or implicit SVLs (see 
Supervisor Linkage Control in Chapter 6). Base register 3 
is used by the Function Call Double instruction to point 
to the stack. Byte register hex F is used by the 
Translate and Test instruction, the Move Packed Shifted 
instruction, and the Move Packed Shifted Zero 
instruction. Byte registers hex A and B and base 
registers hex E and F are used by the Edit Pack Decimal 
instruction. Halfword registers hex E and F are used by 
the Convert Character to SNA, Convert Characters to 
MULTI-LEAVING Remote Job Entry, Convert 
MULTI-LEAVING Remote Job Entry to Character and 
Convert SNA to Character instructions. Halfword 
register hex E is used by the Trim instruction. However, 
these uses do not preclude the use of these registers for 
other operations. 


The remaining base registers have no specific 
assignments and can be used to address various spaces 
(up to 64 K-bytes each) in virtual storage. 


I/O INTERRUPTIBILITY 


Pending interrupts are normally granted following 
instruction execution. Two additional special interrupt 
tests ensure minimal interruption delay. 


The first special interrupt test is at the end of a unit of 
operation (the amount of CPU processing that occurs 
between interrupt points). Uninterruptible IMP 
instructions normally use one unit of operation. 
Interruptible IMP instructions, built-in functions, and 
HMC procedures may use multiple units of operation. 
The microcode handles interruptible IMP instructions 
and built-in functions by checkpointing the function to 
the beginning of the next unit of operation and then 
granting the interrupt. When control is returned to the 
procedure containing the interrupted function, execution 
is resumed at the checkpointed unit of operation. 


The checkpoint facility varies with the IMP instruction or 
built-in function (for example, MVCL or GHRF). The 
interrupt checkpoint facilities are described as a part of 
the instruction specification. 
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The second special interrupt test is required by 
instructions that take an unusually long time to execute. 
This class of instructions has the following 
characteristics: 
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- The instruction or built-in function is not designed as 
being interruptible. 


e The worst-case path exceeds 450 microseconds, 
including overlay time and lookaside buffer-miss 
time. 


The special interrupt tests are inserted into HMC to 
ensure a response time of 450 microseconds. If an |/O 
interrupt is pending when a special test is performed, 
one of two procedures is used: 


e If the result is computed internally in an HMC work 
area and is not stored back until the computation has 
been completed, the partially computed result is 
discarded, the IAR (instruction address register) is 
nullified, and the interrupt is granted. Execution is 
resumed at the beginning of the instruction or built-in 
function that was interrupted. The IMP interface 
interprets the partially completed computation as if it 
were never performed by the CPU. 


Note: Interrupt tests are performed before IMP | ) 
facilities (result field and condition code) have been 
modified. 


- If the result is stored back as it is being computed, 
HMC checkpoints the instruction or built-in function 
internally, processes the |/O interrupt (any resultant 
task switch does not occur until the instruction or 
built-in function is completed), and resumes 
processing the instruction at the point of interrupt 
detection. 


This type of interrupt processing can occur during the 
execution of a TR or TRR instruction, or during the 
execution of built-in functions that perform CRE 
(call/return element) chain searches or move-TDEs (task 
dispatching element [from one queue to another ]), or 
during IMP queuing instructions. The queuing (built-in 
function or IMP instruction) checkpoint mechanism is 
described under Send/Receive Queue Busy Status later in 
this chapter. 


INTERNAL MICROPROGRAM TASKING 


IMP tasking allows task switching from a procedure in a 
given task to a procedure in a different task. All task 
switches are caused by a built-in processor function 
known as the task dispatcher. 


The following paragraphs deal with the tasking structure 
of the IMP, describe the objects that make up the 
tasking structure, and describe how the tasking structure 
is used. 


Tasking 
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TASKING STRUCTURE 
Task Dispatching Queue 


One or more TDQs (task dispatching queues) exist in the 
system. The prime TDQ is used by the task dispatcher 
to allocate processor time to the active tasks in the 
system. The elements chained to the prime TDQ are 
those TDEs (task dispatching elements) associated with 
dispatchable tasks (for example, tasks not waiting for a 
message from an SRQ [send/receive queue ]). TDEs 
for the dispatchable tasks are ordered on the prime TDQ 
in priority sequence according to the priority field in the 
TDE. 


The format of a TDQ is as follows: 


First TDE Address 


Descriptor 





0 Bytes 2 
Bytes 
(Hex) Bits Description 
0-1 Descriptor: 


0-2 Identifies this IMP object as a TDQ 
(= 000). 


3 O The TDQ is empty. 
1 This TDQ has one or more TDEs. 
4-15 Reserved. 


2-7 First TDE Address: First TDE if any, 
associated with this TDQ. 


5-4 
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When accessed as the result of a send or receive type 
instruction, a TDQ must be resident in storage, fullword 
aligned, and must not cross a page boundary; otherwise 
a machine check will occur when the TDQ is accessed. 
However, if any of the above conditions are not met for 
EQTDE (Enqueue Task Dispatching Element) or DOTDE 
(Dequeue Task Dispatching Element) instructions, a 
specification, addressing, or address translation 
exception occurs. 


Task Dispatching Element 


A TDE (task dispatching element) is an IMP object used 
to identify a task and the attributes (including a priority) 
associated with that task. It also contains fields used to 
store or load the current state of the task at the time of 
a task switch. The TDE for a particular task can appear 
as an element on a TDQ (task dispatching queue) or can 
be enqueued to an SRQ (send/receive queue) or an 
SRC (send/receive counter) wait list. If a task is eligible 
for instruction execution, the associated TDE appears on 
the prime TDQ. 





The format of the TDE is as follows: 





0 Bytes 2 8 


Control . Exception 
FE 
Mode irst CRE Address Mask 





C Bytes E 14 


Exception 


Current Queue Address 
Occurrence 





16 Bytes 1c 





1E Bytes 24 













Base 


Address Register Registers 


Time Quantum Status 







29 Bytes 2C 30 32 


Exception 


Used by VMC TDE Identifier Hold Count 
Code 





92 Bytes 94 96 98 


Computational 


PEM Start Address Attributes 





9A Bytes AO Al 


PEM Stop Address Used by VMC 





A2 Bytes A8 


Reserved for VMC Checkpoint Area Reserved for HMC 





BO Bytes CoO C6 


Used by VMC 


DO Bytes FF 
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Bytes 
(Hex) 


0-1 


5-6 


Bits 


0-2 


Description 
Descriptor: 


Identifies this IMP object as a TDE 
(= 001). 


Reserved. 
O This is the last TDE on the chain. 


1 This is not the last TDE on the 
chain. 


O This TDE is free to be enqueued to 
a queue header. 


1 This TDE is already enqueued to a 
queue header. 


On a Dequeue TDE instruction, this bit 
is reset, indicating that this element is 
no longer enqueued to any queue. On 
an Enqueue TDE instruction, this bit is 
checked first. If it is one, a 
specification exception is raised. If it is 
zero, the TDE is enqueued and this bit 
is set to one. 


O This TDE was not removed from the 
prime TDQ by a SENDMW 
instruction. 


1 This TDE was removed from the 
prime TDQ by a SENDMW 
instruction. 


O The address of the TDQ to which 
the TDE will be moved when 
dequeued from a wait list is 
contained in bytes hex 1E-23 of the 
TDE. 


1 The TDE removed from a wait list 
by a send operation is to be 
enqueued on the prime TDQ. 


Used by the processor to monitor 
access of this TDE. If not hex OO, the 
TDE is monitored for access 
exceptions. 


Bytes 
(Hex) Bits 
2-7 
8-B 
0-31 
C-D 
0-1 
2 
3 
4 
5 
6 


2 


Description 


Next TDE Address: Address of the 
next TDE. If this is the last TDE in the 
chain, descriptor bit 4 = 0. 


Priority: 

Highest priority is zero. TDEs are 
enqueued in priority sequence, last 
within the same priority, when moved 
to a TDQ by a send type operation or 
Enqueue TDE instruction. 

Control Mode: 

Reserved. 

O Do not perform trace function. 


1 Perform task trace function. 


O Any SVLM11 instruction executes as 
a no-operation. 


1 Any SVLM1 instruction executed in 
this task defaults to an SVL1 
instruction. 
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O The CRE (call return element) list is 
empty. 


1 One or more CREs are chained to 
this TDE. 


O Task not timed. 
1 Timed task. 


O Not in PEM (program event monitor) 
mode. 


1 In PEM mode. 





Bytes 
(Hex) 


C-D 
(cont) 


14-15 


Bits 


7 


10 
11 
12 
13 
14 


15 


Bytes 


Description (Hex) Bits 
O Any SVLM instruction executes as a 16-1B 
no-operation. 
1 Any SVLM instruction executed in 
this task defaults to an SVLO 
instruction. 1C-1D 
The maximum number of available 0 
CREs to be left chained to the TDE by 
the execution of an SVX instruction. 1 
Whenever the number of available 
CREs would exceed this number as a 2-4 
result of an SVX instruction, one is 
returned to the ACQ (available CRE 5 
queue). At least one available CRE is 
always left chained to the TDE by an 6 
SVX instruction. 
7 
First CRE address: If no CREs are 
associated with this TDE, bit 4 of byte 8-9 
hex C = 0. 
10 
Exception Mask: 
11 
Bit off = masked, bit on = allowed. 
Binary overflow. 12 
Decimal overflow. 13 
Reserved. 14 
Monitored SRQ header. re 
Monitored SRM header. 
1E-23 
Monitored TDE header. 
PEM (see Chapter 9). 
Address compare (see Chapter 9). 
Floating-point overflow. 
Floating-point underflow. 
Floating-point zero divide. 24-2B 0-41 
Floating-point inexact result. 
42-63 


Floating-point invalid operand. 


Reserved. 


Description 

Current Queue Address: Address that 
TDE is enqueued to. If TDE is not 
enqueued to an SRC, SRQ, or TDQ, 
descriptor bit 5 = O. 

Exception Occurrence: 

Binary overflow. 

Decimal overflow. 

Reserved. 

Monitored SRQ header. 

Monitored SRM header. 

Monitored TDE header. 

Reserved. 

Floating-point overflow. 
Floating-point underflow. 
Floating-point zero divide. 
Floating-point inexact result. 
Floating-point invalid operand. 
Reserved. 

TDQ Address: lf descriptor bit 7 = O, 
these bytes contain the address of the 
TDQ to which the TDE it to be 
enqueued when removed from a wait 
list by a send operation. If descriptor 
bit 7 = 1, the address contained in 
these bytes !s ignored and the TDE is 


enqueued to the prime TDQ. 


Time Quantum: The time remaining in 
this task (bit 41 = 1024 microseconds). 


Reserved. 
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Bytes 
(Hex) 


2C-2F 


30-31 


32-91 


92-93 


94-95 


96-97 


5-8 


Bits 


Description 

Status: 

Reserved. 

OQ IMP procedure. 

1 HMC procedure. 

Not used. 

Reserved. 

Zero. 

ILC (instruction length count). 

Zero. 

Condition Code: When initializing the 
condition code field in a new TDE, at 
least one, but not all, of the bits must 
be set to 1. Failure to do so may cause 
branch instructions to work incorrectly. 


Address Register: 


IAR (instruction address register) if bit 
1 of byte hex 2C = 0. 


CSAR (control storage address register) 
if bit 1 of byte hex 2C = 1. 


Base Registers: Note that all 16 base 
registers are always saved and restored 
on a task switch. The registers occupy 
6 bytes per register beginning with 
byte hex 32. 


Used by VMC. 
TDE Identifier. 


Hold Count: Object hold count for this 
TDE. 


Bytes 


(Hex) Bits 


98-99 


9A-9F 


AO 


1-2 


3-7 
Al 
A2-A7 
A8-AF 
BO-BF 


CO-C5 


CO-C1 


Description 


Exception Code: Refer to bytes hex 
74-75 of the CRE definition in 
Chapter 6. 

PEM Start Address. 
Computational Attributes. 
Reserved. 

Rounding Mode. 

0O Round toward positive infinity. 
01 Round toward negative infinity. 
10 Round toward zero. 

11 Round to nearest. 

Reserved. 

Not used. 

PEM Stop Address. 

Used by VMC. 

Reserved for VMC. 

Checkpoint Area. 

The hold/free functions use this area 
to pass exception information. 

Hold Hash Table Entry Offset: 
Contains the offset when a second 
chain search exception is encountered 
during a Grant instruction, or when a 


monitored exception is encountered 
during a Free instruction. 





# 


Bytes 

(Hex) Bits Description 

C2-C3 Index or Pointer: Contains either 

e An index to the hold record 

preceding the hold record that is at 
the head of the secondary chain 
after a second chain search 
exception for a Grant instruction, 


« A pointer to the head of the 
secondary chain for a second chain 
search exception on a Free 
instruction, or 


« A pointer to the hold record (on the 
primary chain) preceding the 
monitored hold record on a 
monitored exception. 


C4-C5 Index: An index pointing to an 
available hold record. 


C6-CF Reserved for HMC. 
DO-FF Used by VMC. 


The TDE extends beyond byte hex CF. This portion, 
which is not used by HMC, is described in the Vertical 
Microcode Data Areas manual. 


Task switching mode/task control mode (bytes hex 
C-D) for bits 2, 3, 5, 6, and 7 is established by the 
processor at task switch time when a task becomes 
active. If the task control mode bits 2, 3, 5, 6, and 7 
are changed in a TDE while its task is active, the new 
mode does not become effective until the next time the 
task becomes active as the result of a task switch. 
However, the Dispatch TDQ instruction will test bit 6 
and will appropriately enable or disable PEM mode for 
an active task. The Dispatch TDQ instruction also tests 
bit 1 for a task switch trace, tests control mode bits 3 
and 7, and enables or disables the task-wide 
SVL-monitored no-operation. 


The computational attributes for a task are set when the 
task executes its first floating-point instruction after 
being dispatched. The floating-point inexact result 
exception mask and the exception occurrence bits are 
also set at this time. The attributes remain in effect 
(even though bytes 15, 1D, or AO of the TDE may 
change) until the task is dispatched once again. In order 
to ensure that the computational attributes being used 
match the computational attributes in the TDE, a 
Dispatch TDQ instruction for the current TDQ should be 
executed. The exception mask (bytes 14 and 15) is 
tested each time a maskable exception is recognized to 
determine if the exception should be taken. 


The following exceptions are maskable: 


Address compare (see Chapter 9) 
e Binary overflow 

e Decimal overflow 

¢ Floating-point inexact result 

¢ Floating-point invalid operand 
e Floating-point overflow 

e Floating-point underflow 

¢ Floating-point zero divide 

¢ Monitored SRO header 

e Monitored SRM header 

e« Monitored TDE header 


« Program event monitor (see Chapter 9) 
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The following exceptions can occur at the same time as 
any other IMP exception: 


¢« Monitored ACQ descriptor (SVL receive) 
¢« Monitored CRE descriptor (SVL receive) 
« Monitored TDE descriptor (SVL receive) 
« Address compare 

e Task interval timer 


Bytes hex 14 and 15 (exception mask) are tested each 
time a maskable exception is recognized. If the 
exception is not masked, the occurrence is recorded in 
the CRE (call/return element) and an SVL (supervisor 
linkage) is taken. If the exception is masked, the 
occurrence is recorded in the exception occurrence field 
of the TDE and an SVL is not taken. See Chapter 6 for 
further information in the handling of exceptions. 


TDEs must be resident in storage, fullword aligned and 
must not cross a page boundary; otherwise a machine 
check occurs when the TDE is accessed as the result of 
a send or receive type operation. When the TDE is 
accessed as a result of an EQTDE or DQTDE instruction, 
a specification, addressing, or address translation 
exception occurs. 


Send/Receive Queue 


An SRO (send/receive queue) is an IMP object used to 
exchange intertask information and to synchronize the 
flow of control between tasks. One task can 
communicate with another task by issuing a send type 
instruction to an SRO or an SRC (send/receive counter). 
Another task can then obtain the information from the 
queue or counter by issuing a receive type instruction. 


Task synchronization is provided by using send/receive 
messages and an SRQ in the following manner. When a 
procedure within the active task issues a Receive 
Message instruction and the target SRQ either (1) has 
no messages, or (2) has no message that satisfies the 
search argument for the Receive Message instruction, 
the task does not proceed. Instead, the task is placed in 
the receive wait state by the processor by dequeuing its 
TDE (task dispatching element) from the TDQ (task 
dispatching queue) and enqueueing that TDE to the wait 
list of the target SRQ. The task dispatcher is then 
invoked to determine the next task to be activated. 


A Send Message instruction is the counterpart to a 
Receive Message instruction. If a message has been 
enqueued by a Send Message instruction to an SRO 
and there are TDEs waiting the value of byte O bit 7 of 
the SRQ determines the action taken. If bit 7 equals: 


0 The TDEs are dequeued from the SRQ wait list 
and enqueued in priority sequence on their 
appropriate TDQ. 


1 The first TDE is dequeued from the SRQ wait 
list and enqueued in priority sequence on their 
appropriate TDQ. 


The task dispatcher is then invoked if the task switch 
control bit is zero (bit 15 of the SENDM instruction) and 
a TDE was enqueued to the TDQ at a higher priority 
than the current TDE. If these conditions are present, a 
task switch occurs. This switch is referred to as a 
preempt wait to the task issuing the send operation. 


Send and receive type operations are executed explicitly 
as instructions by IMP tasks as well as implicitly by 
HMC functions. 


J 





The format of the SRQ header is as follows: 


Descriptor 





0 Bytes 





A 
Bytes 
(Hex) Bits 
0-1 
0-2 
3 
4 
5 
6 


Description 


Descriptor: 


First TDE Address 


First Message Address Reserved 


Bytes 10 


Bytes 


(Hex) Bits 


0-1 7 


Identifies this IMP object as an SRO 
(= 010). 


0 


The SRQ header contains no TDEs 
(task dispatching elements). 


One or more TDEs are enqueued to 
the wait list. 


The SRQ contains no SRMs 
(send/receive messages). 


One or more SRMs are enqueued to 
the message list. 2-7 
An access is not in progress. 


An access is in progress by a task 

whose TDE address is indicated in 9 
the reserved field. An access 

attempt by any other task causes a 

busy exception. 


No monitored TDEs are enqueued to 
the wait list. 
10-1F 
One or more monitored TDEs are 
enqueued to the wait list. 


Note: This bit is set/reset by the VMC and tested by 


the HMC. 


Reserved 


Key 
Lth-1 


20 


Description 


O All TDEs are moved to the 
appropriate TDQ when a message is 
enqueued by a Send Message 
instruction to the SRQ. 


1 The first TDE is moved to the 
appropriate TDQ when a message is 
enqueued by a Send Message 
instruction to the SRQ. 


Used by the processor to monitor 
accesses to this object. If not hex 00, 
the SRQ is monitored for access 
exceptions. 


First TDE Address: If no TDEs are 
waiting; descriptor bit 3 = 0. 


Reserved. 


Key Length-1: Number of bytes of 
message key, starting with byte 8 in 
the SRM. 


First Message Address: If no SRMs 
are enqueued, descriptor bit 4 = 0. 


Reserved: Bytes hex 10-11 and hex 
18-19 contain checkpoint status. Bytes 
hex 12-17 contain the owner TDE 
address if the queue is busy (descriptor 
bit 5 = 1). Bytes hex 1A-1F contain 
the last message searched address if 
interrupted during a message search. 


Note: An SRQ header must be fullword aligned and not 
cross a page boundary; otherwise a specification 
exception occurs when the object is referenced. 
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Send/Receive Message 
The messages that are enqueued to the SRO J 
(send/receive queue) take the form of an IMP object 


called an SRM (send/receive message). 


The format of an SRM header is as follows: 





Descriptor Next Message Address Message 
0 Bytes 2 8 k+1 n 
Bytes Bytes 
(Hex) Bits Description (Hex) Bits Description 
0-1 Descriptor: 6 0 A SENDMW instruction has not been 
issued. 


0-2 Identifies this IMP object is an SRM (= 


011). 
3 Reserved. 
4 O This is the last SRM on the chain. 


1 This is not the last SRM on the 
chain. 


5 O SRM is free to be enqueued to a 
queue header. 


1 SRM is already enqueued to a 
queue header. 


This bit is set to zero by those 
instructions that dequeue an SRM from 
a queue header. Those instructions that 
enqueue an SRM check this bit first. If 
it is one, a specification exceptions 
occurs. If it is zero, the SRM is 
enqueued to the designated queue and 
this bit is set to one. 


A SENDMW instruction has been 
issued. 


When the OU task has finished 
processing this SRM, the TDE specified 
at byte 122 of the SRM is enqueued to 
the TDQ indicated by this TDE. When 
the OU attempts to restore the TDE to 
the TDQ, the TDE address field of the 
SRM must be contained in the same 
page as byte O of the SRM or a 
machine check occurs. 


When a SENDMW instruction is being 
executed, the SRM must contain the 
address of a TDE at byte hex 7A. This 
address must reside on the same page 
as the SRM descriptor or a machine 
check will occur. 


Reserved. 


Bytes 

(Hex) Bits Description 
0-1 8-15 Used by the processor to monitor 
accesses of this object. If not hex O00, 
the SRM is monitored for access 


exceptions. 


2-7 Next Message Address: If no 
additional SRMs are enqueued, 
descriptor bit 4 = 0. 


8-k Key: Message key of the length 
indicated in the SRQ, plus the message 
text. The length of the key will 
determine the location of the starting 
point (k+1) of the message. 

(k+1)-n Message: Text of message does not 

have a set length. 


Note: While the SRM message text may cross page 
boundaries, the SRM descriptor, next SRM pointer, and 
SRM message key must be in the same page and the 
SRM descriptor must be fullword aligned or a 
specification exception occurs when the SRM is 
referenced. 


The key field is not checked for a page crossing when 
an enqueue-first or enqueue-last operation is 
performed. 


Send/Receive Counter 


An SRC (send/receive counter) is an IMP object used in 
much the same way as an SRO (send/receive queue) 
except that no messages are enqueued. Instead, a Send 
Count instruction causes the count field in the SRC 
header to be increased by 1 (see note). 


A Receive Count instruction causes the count field value 
to be decreased by the counter limit value (see note) if 
the count field value equals or exceeds the count limit 
value. The count field and limit values are treated as 
16-bit unsigned numbers. If the count value does not 
equal or exceed the limit value, the task is placed in 
receive wait state by dequeuing its TDE (task 
dispatching element) from the TDQ (task dispatching 
queue) and enqueuing that TDE to the wait list of the 
target SRC. The task dispatcher is then invoked to 
determine the next task to be dispatched. 


When a Send Count instruction is issued, the count is 
incremented by 1; then a check is made to determine if 
the count value has reached or exceeded the limit value. 
If so, the associated SRC wait list is interrogated. If 
there are TDEs waiting and byte O bit 7 equals: 


O The TDEs are dequeued from the SRC wait list 
and enqueued in priority sequence to the TDQ 
specified by byte hex 1E of the TDE. 


1 The first TDE is dequeued from the SRC wait list 
and enqueued in priority sequence to the TDOQ 
specified by byte hex 1E of the TDE. 


The task dispatcher is then invoked if the task switch 
control bit is zero (bit 15 of the SENDC instruction) and 
a TDE was enqueued to the current TDQ at a higher 
priority than the current TDE. This switch is referred to 
as a preempt wait to the task issuing the send operation. 


Note: The HMC handles the increasing and decreasing 


count field value. See the Processing Unit 
Theory-Maintenance manual. 
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The format of an SRC is as follows: 


First TDE Address 


Descriptor 





0 Bytes 2 

Bytes 

(Hex) Bits Description 

0-1 Descriptor: 
0-2 Identifies this IMP object as an SRC 

(= 100). 
3 O No TDEs are enqueued to the wait 
list. 


1 One or more TDEs are enqueued to 


the wait list. 

4-6 Reserved. 

7 O All TDEs are moved to the 
appropriate TDQ when the limit 
value has been reached or exceeded. 

1 The first TDE is moved to the 
appropriate TDQ when the limit 
value has been reached or exceeded. 

8-15 Reserved. 

2-7 First TDE Address: If no TDEs are 
waiting, then descriptor bit 3 = 0. 

8-9 Count value. 

A-B Limit value. 


Note: An SRC must be fullword aligned and not cross a 
page boundary; otherwise, a specification exception 
occurs when the SRC is referenced. 


8 A Cc 
Enqueue/Dequeue Instructions 


Enqueue and Dequeue instructions are used to control 
IMP objects composing the tasking structure. The 
enqueue instructions insert SRMs (send/receive 
messages) on SROs (send/receive queues) and insert 
TDEs (task dispatching elements) on wait lists of SROs 
or SRCs (send/receive counters), or on TDQs (task 
dispatching queues). Dequeue instructions remove 
SRMs from SRQs and remove TDEs from the wait lists 
of SRQs, SRCs, or TDQs. Unlike send/receive 
instructions, enqueue /dequeue instructions neither 
invoke the task dispatcher nor cause a task switch. 


Send/Receive Queue Busy Status 


Some of the send, receive, enqueue, and dequeue 
instructions are interruptible. Figure 5-1 shows the 
interruption causes for instructions that are interruptible, 
can set busy status, and observe busy protocol. An 
SRQ (send/receive queue) is set into busy status by the 
processor whenever an instruction that accesses it is 
interrupted before completion. Busy status occurs as 
follows. When the processor detects that an SRO 
access instruction must be interrupted, the descriptor 
busy bit (byte 0, bit 5) is set, and the pin count for the 
page containing the SRQ is incremented if the page is 
V=V page (pin count is the value of a counter used to 
indicate that a page is pinned [or held] in storage). A 
nonzero value of pin count indicates that the page is in 
use and should not be removed from storage (see 
Primary Directory in Chapter 8). The TDE (task 
dispatching element) address of the task that was 
executing the instruction and the instruction interruption 
point are then recorded in the reserved area of the SRQ. 


J 





If any task attempts to execute an instruction that 
accesses a busy SRQ, the TDE address of that task is 
compared to the TDE address saved in the header of. 
the busy queue. If the TDE addresses are not equal, the 
accessing instruction is nullified and a descriptor access 
busy exception is raised to the issuing task. If the TDE 
addresses are equal, this implies to the processor that 
the interrupted instruction of the owner task is resuming 
the operation. In this case, the busy bit is reset, the pin 
count of the page containing the SRO is decreased, the 
instruction interrupt point is restored from the 
checkpoint area, and instruction execution proceeds 
normally. 


Note: The exception handling routine should not 
perform an operation (other than the original one) that 
accesses a busy SRO in the task producing the 
exception (task whose TDE address is stored in bytes 
hex 18-23 of the SRQ). If this condition occurs, the 
processor assumes that the suspended instruction is 
being resumed, resulting in an unpredictable operation. 


Access Exception 


Page Fault | 
Monitored (Note 1) | 


Due toa 


Nonresident 

SRM ona 
Interruptible Message 
Instruction List 














SENDMW 
RECM 


SVLO 








SVL1 
SVL2 





Notes: 

1. Refers to nonzero descriptor byte 1 of TDE, SRQ, or 
SRM. 

2. On Enqueue and Dequeue TDE instructions, if the 
first operand is a TDE or SRC, a monitored TDE does 
not cause an access exception. 





Figure 5-1. Interruptible Instruction Summary Chart 


Interrupts due to |/O are recognized as follows: 


When the processor searches the second or 
subsequent SRM on an SRO (before moving a 
second or subsequent TDE from an SRC or SRO wait 
list), or 


When the processor searches a TDE or CRE chain 


These interrupts are ignored when the processor 
searches the first SRM on an SRO, or when the 
processor moves the first TDE from an SRC on an 
SRQ. When the |/O interrupt is handled, only the 
address events and the load multiple register events 
are processed. The remaining events are handled 
when the resumed queueing operation completes. 
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TASK CONTROL 

Task control consists of: 
e Task dispatching 

e Task switching 


e Task timing 


Task Dispatching 


The dispatching of IMP tasks is handled by an HMC 
function known as the task dispatcher. The task 
dispatcher is invoked explicitly by the Dispatch TDQ 
(task dispatching queue), the Enable Task Dispatching 
instruction, or, under certain conditions, by the 
send/receive type instructions or implicit send/receive 
operations. It is the responsibility of the task dispatcher 
to determine when a task switch is necessary, to 
determine which task should be dispatched next, and to 
accomplish the indicated task switch. During a task 
switch, the status of the old task is saved (as described 
under Call/Return Element in Chapter 6) in that task’s 
TDE (task dispatching element). The status of the new 
task is taken from the new task’s TDE. 


The primary IMP structure associated with the task 
dispatching function is the TDQ. The TDE that 
represents the active task is located in the TDQ and is 
referred to as the current TDE. The current TDE is 
normally the top TDE on the TDQ whenever the task 
dispatcher is enabled. When the task dispatcher is 
disabled or if a send without task switch occurred, the 
current TDE may or may not be the top TDE on the 
TDQ. 


The task dispatcher is invoked: 


1. | When a DTDOQ (Dispatch TDQ) instruction is 
encountered. 


2. | When an implicit or explicit send operation (Send 
Message or Send Count instruction) occurs and a 
TDE is placed on the TDQ at a higher priority than 
the current TDE. 


3. | When an implicit or explicit receive operation 
(Receive Message or Receive Count instruction) 
occurs and the receive is not satisfied. In this 
case, the current TDE is removed from the TDQ 
and placed on an SRC or SRO (send/receive 
queue) wait list by the receive operation. 


4. | When an Enable Task Dispatcher instruction is 
issued and the top TDE on the TDQ is not the 
current TDE. 


The task dispatcher functions as follows: 


e In the above cases a task switch may occur to the 
top TDE on the TDQ. For the third case, the TDQ 
may be empty. If the TDQ is empty, the processor 
waits until a new TDE is placed on the TDQ. 


e When a new task is dispatched as a result of any of 
the previous conditions, the TDQ and the current TDE 
addresses in the control address table are updated as 
required. If the exception code is nonzero in the new 
task TDE, the exception is presented via an exception 
SVL. If no exceptions are present, instruction 
processing then commences with the instruction 
addressed by the IAR (instruction address register) or 
CSAR (control store address register) of the new 
task. 


Dispatcher control addresses are accessed and 
maintained by the processor in support of the task 
dispatching function. These control addresses, located 
in the control address table (see Figure 2-2), are 
composed of the TDQ address and the current TDE 
address. 
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Task Switching 


Having determined that a task switch is required, the 
task dispatcher stores the state of the old task in the 
TDE (task dispatching element) of the task. Stored 
status includes the condition code, the instruction 
length, the IAR (or CSAR if a horizontal microcode 
function), base registers hex O-F, and the exception 
code. Also, bit 1 of byte hex 44 (status) in the TDE is 
set to indicate either an IMP or HMC procedure. The 
task dispatcher then determines which task is to be 
dispatched next as previously described. The new task 
TDE address is then stored in the current TDE address 
field of the control address table and the status of the 
new task is loaded from the new TDE. The control 
mode (defined as part of the TDE in this chapter) is 
established from the TDE. Any pending exceptions are 
presented via an exception SVL (supervisor linkage). 
Otherwise instruction execution is initiated beginning 
with the instruction addressed by the IAR and register 
S(O) or by the CSAR. 


The processor enters the wait state as follows. The 
active task is the only TDE on the TDQ, and it issues a 
receive type operation that is not satisfied. This causes 
its TDE to be removed from the TDQ and placed on the 
wait list of the SRO (send/receive queue) or SRC 
(send/receive counter) referenced by the receive type 
operation. The task dispatcher is then invoked and the 
task status is stored in the TDE of the task. The 
processor is then placed in the wait state since the TDQ 
contains no TDEs. 


Subsequently, when one or more TDEs are placed on 
the TDQ and the task dispatcher is invoked, the status 
of the first TDE on the TDQ is loaded into the 
processor, the control address table is updated, and 
instruction execution commences. 


Task Dispatcher Enable/Disable Functions 


Two instructions are provided to allow disabling and 
enabling of the task dispatcher function. The Disable 
Task Dispatching instruction inhibits the task dispatcher 
and stops the task interval timer. While in this mode, no 
task switches can occur. Furthermore, a machine check 
occurs if a Receive Message, Receive Count, or 
Dispatch Task Dispatching Queue instruction, or an SVL 
(supervisor linkage) is attempted. This condition is also 
entered implicitly as a result of a machine check. The 
Enable Task Dispatching instruction resets this condition, 
starts the task interval timer if the current task is timed 
and no task switch occurs, and invokes the tas 
dispatcher. If an exception occurs while the task 
dispatcher is disabled, it is reported as a machine check 
(see Processor Machine Check Handler in Chapter 9). 


Task Timing 


An IMP task can be either timed or untimed as indicated 
by bit 5 of byte hex 12 in the task TDE (task dispatching 
element). Task timing is provided by a built-in function 
called the task interval timer. When a timed task is 
activated by the task dispatcher, the time quantum bytes 
(hex 24-2B) of the TDE are loaded into the task interval 
timer. If this timer decreases to zero while a timed task 
is active, a task timer exception occurs. For untimed 
tasks, the time quantum field is not used and the task 
interval timer is not decreased. 


When a timed task is set to the wait state as part of a 
task switch, the contents (residual value) of the task 
interval timer are stored into the time quantum field of 
the task TDE. 


Note: If the task dispatcher is disabled by either the 
Disable Task Dispatching instruction or a machine check 
and the active task is timed, the task interval timer is 
stopped. When an Enable Task Dispatching instruction 
is issued, the following operation results. |f a task 
switch occurs, the new task TDE specifies timed or 
untimed. If a task switch did not occur, timing is 
resumed by the task interval timer if so indicated by the 
current TDE. 


If an untimed task issues a Set Interval Timer instruction 
to the task interval timer, a specification exception is 
presented. A Store Interval Timer instruction by an 
untimed task that specifies the task interval timer stores 
unpredictable results. 
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INTERTASK COMMUNICATIONS AND 
SYNCHRONIZATION 


Communication between tasks and control of 
synchronization is provided by the send/receive 
mechanism within the tasking structure. 


An example of intertask communication is shown in 
Figure 5-2. The SRQ-A is initially empty. Task A then 
executes a Send Message at instruction which 
enqueues the message to the SRQ. Subsequently, when 
task B is dispatched and issues a Receive Message 
instruction the message is dequeued from the SRO 
for use by task B. 


The synchronization function of these two instructions is 
illustrated in Figure 5-3. The first two tasks on the TDQ 
are TDE B and TDE A; TDE B has the higher priority. 
Task B is the active task and the processor is executing 
procedure B (Figure 5-3/[a]). 


When the RECM C instruction is executed, a message 
cannot be dequeued since SRQ C has no message. 


Therefore, the IAR is not incremented and the receive 
operation places task B in the receive wait state as 
follows: 


« Dequeues TDE B from the TDQ 


e Enqueues TDE B to the wait list of SRO C (Figure 
5-3[b]) 


e Invokes the task dispatcher 


Task A SRQOA 











Figure 5-2. Intertask Communications 


The task dispatcher then performs a task switch as 
follows: 2 


e Determines that the current TDE (TDE B) is not first 
on the TDOQ 
e Stores the state of task B in TDE B 


e Determines that TDE A is now the highest priority 
dispatchable task 


e Loads the state of task A (procedure A) from TDE A 


e Updates the control address table entry for the 
current TDE 


e Initiates processing of procedure A 

Procedure A now issues a SENDM C instruction which 
enqueues an SRM to SRQ C. Since TDE B is on the 
wait list, the send operation also: 


e Dequeues TDE B from SRQ C 


« Enqueues TDE B to the TDQ above TDE A (Figure 
5-3[c]) since TDE B has a higher priority 


' 
« Invokes the task dispatcher since a TDE was moved S) 
to the TDQ 





RECM 








The task dispatcher then: 


« Determines that the current TDE (TDE A) is not first 
on the TDQ 


« Stores the state of task Ain TDEA 


e Determines that TDE B is now the highest priority 
dispatchable task 


« Loads the state of task B 


e« Updates the control address table entry for the 
current TDE 


e Initiates processing of procedure B 


Since the IAR for task B still points to the RECM C 
instruction, it is again executed. The SRM is now 
dequeued and execution of procedure B continues under 
task B since the receive operation was satisfied. 


Similar functions are also associated with the SRC (send 
receive counter) object together with the Send Count 
and Receive Count instructions except that no messages 
are passed. 
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(a) SRQOC Procedure B 


Procedure A 


; 





Active | SENDM C | 
Task 
Inactive 
Dispatchable 
Task 
(b) SROC Procedure A 






SENDM C 


L 






Active Procedure B 
TDEA ? Task 
RECM C 
Bd 
Re eee ER oe ee ae eT Se a 
(c) SROC Procedure B 





Procedure A 


Figure 5-3. Task Synchronization Example 
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Chapter 6. Supervisor Linkage and Exception Presentation 


This chapter describes IMP (internal microprogramming) 
supervisor linkage concepts and IMP exception 
presentation. 


« IMP Supervisor Linkage is the method by which IMP 
procedure switching within the same task is 
accomplished. A supervisor linkage can be explicit or 
implicit and saves the status of the procedure from 
which the switch occurred. 


e IMP Exception Presentation is the mechanism by 
which a defined set of exception conditions is 
presented, including the invocation of the IMP 
exception handling procedure. 
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Supervisor Linkage SUPERVISOR LINKAGE STRUCTURES ; 
| ) 


The IMP extended program linkage facility calls an SVL Three structures are used to control the supervisor 
(supervisor linkage) routine to perform one of the linkage operation: The CRE (call/return element), the 
following functions: ACQ (available CRE queue), and the SVL (supervisor 
linkage) table. The ACQ address and the SVL table 
- An extended IMP operation whose entry point is not address are contained in the control address table (see 
addressed directly (explicit SVL). Figure 2-2). 


e Simulation of an IMP instruction that has been 
trapped by the IMP interpreter (implicit SVL). 


¢ Handling of a processor exception (exception SVL). 
For all three functions, the IMP routine performing the 
function returns via an explicit Supervisor Exit 
instruction. 

The basic services provided by the SVL mechanism are 


selective IMP procedure status saving/restoring and 
entry point resolution via a specialized SVL table. 
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Call/Return Element 


A CRE (call/return element) is a resident storage area 
used to save the status of a procedure during an SVL 
(supervisor linkage). If the CRE is not resident, is not 
fullword aligned, or crosses a page boundary, a machine 
check occurs when the CRE is accessed. 


The descriptors of the CRE and the SRM (send/receive 
message) are identical. The key is not significant since 
all queuing functions are first on the chain. A CRE has 
the following format: 


Descriptor Next CRE Address 





0 Bytes 2 














Address 
Register 






Status 





Base Registers 


8 Bytes Cc E 












Exception 
Code 





ACO Address 







Not Used 


6E Bytes 74 76 80 
Bytes Bytes 
(Hex) Bits Description (Hex) Bits Description 
0-1 Descriptor: Element descriptor 0-1 5 O This CRE is not enqueued in a 
(same as SRM). chained list. 
0-2 Identifies this IMP object as an SRM 1 This CRE is enqueued in a 
(011). chained list (either an SRQ or 
TDE). This bit is set to zero by 
3 Reserved. those instructions that dequeue 
an SRM from an SRO header. 
4 O This is the last CRE on the chain. Those instructions that enqueue 
an SRM check this bit first. If it 
1 This is not the last CRE on the is a one bit, a specification 
chain. exception is raised. 


6-7 Reserved. 


8-15 Used by the processor to monitor 
accesses to this object. If not hex 00, 
the CRE is monitored for access 
exceptions. 


Supervisor Linkage and Exception Presentation 6-3 


Bytes 
(Hex) Bits 


2-7 


8-B 


16-20 
21-23 
24-27 


28-31 


6-4 


Description 

Next CRE Address: Address of the 
next CRE in the chain. If this is the last 
CRE in the chain, descriptor bit 4 = O. 
Status: CRE Status. 

O Available. 

1 In use. 

O IMP procedure CRE. 

1 HMC procedure CRE. 

Reserved. 

First base register saved. 

Number of base registers saved minus 
one; must include base register O (base 
register addresses wrap around from 
hex F to 0). 

Zero. 

ILC (instruction length count). 

Zero. 

Condition code. When initializing the 
condition code field in a new CRE, at 
least one, but not all, of the bits must 
be set to a one value. Failure to do so 


may cause branch instructions to work 
incorrectly. 


Bytes 
(Hex) Bits 
C-D 
E-6D 
6E-73 
74 (Note 1) 
0-2 
3 
4 
5 
6 
7 


Description 


Address Register: IAR (instruction 
address register) if byte 8, bit 1 = O. 


CSAR (control store address register) if 
byte 8, bit 1 = 1. 


Base Registers: Saved by the SVL 
mechanism; if all registers are not 
saved, the unused area is available to 
the SVL routine as a scratch work area. 
The registers occupy 6 bytes per 
register beginning with byte hex E. 


ACQ Address: Address of ACQ used 
by the SVX operation. 


Exception Code: 
Reserved. 

Soft address compare. 
Task interval timer. 


Monitored ACQ descriptor (SVL 
receive) (Note 2). 


Monitored CRE descriptor (SVL 
receive) (Note 2). 


Monitored TDE descriptor (SVL 
wait) (Note 2). 





C 


Bytes 
(Hex) 


75 (Note 1) 


Bits 


0-7 


Description 


Bytes 


(Hex) Bits 


75 


Exception Code: (Hex) 


00 
02 
04 
06 
08 
OA 


oc 


OE 


10 


12 
14 
16 


18. 


1A 
1C 
1E 
20 
22 
24 
26 
28 
2A 
2c 
2E 


No exception in bits 0-7. 
Invalid descriptor. 

Busy (Note 2). 
Reserved. 

Allocate Page Frame. 


Monitored SRQ descriptor 
(Note 2). 


Monitored SRM descriptor 
(Note 2). 


Monitored TDE descriptor 
(Note 2). 


SRC (send/receive counter) 
overflow. 


Address translation. 
Program event monitoring. 
Execute. 
Specification. 
Addressing. 
Effective address overflow. 
Data. 
Binary overflow. 
76-7F 
Binary divide. 
Notes: 


Decimal overflow. 1 


Decimal zero divide. 


Description 


Exception Code: (Hex) 


30 
32 
34 
36 
38 
3A 
3C 
3E 


42 
46 
48 
4A 
80 
81 

82 
83 
84 
85 
86 


Operation. 

Stack. 

Verify. 

Chain conflict. 

End-of-chain. 

Edit digit count. 

Length conformance. 

Edit mask syntax. 

Invalid segment group address. 
Floating-point invalid operand. 
Second chain search. 
Conversion. 

Invalid floating-point conversion. 
Invalid segment. ' 

Invalid page.' 

Page read error.' 

Invalid pool state.' 

Invalid pin request.' 

Invalid write request. ' 


Main store error.' 


Not used. 


. The exceptions indicated in byte hex 74 can occur 
simultaneously and are not mutually exclusive with 


themselves or with an exception encoded in byte 


Floating-point overflow. hex 75. 


2. Exception code bits 5 through 7 in byte hex 74 and 


Floating-point underflow. 


Floating-point inexact result. 


exception codes hex 04, OA, OC, and OE in byte hex 
75 form the general category of descriptor access 


exceptions described under Descriptor Access 


Floating-point zero divide. 


Exception, later in this chapter. 


‘Implicit SVL codes. For description, see Appendix B. 
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Available Call/Return Element Queue 


The ACQ (available CRE queue) is the mechanism by 
which CREs (call/return elements) are made available to 
the processor and eventually to a TDE (task dispatching 
element). 


An ACQ has the following format: 


First TDE Address 


Descriptor 





0 Bytes 2 


First Available CRE Address 


Key 
Lth-1 


Reserved 


Reserved 





A Bytes 10 


A CRE is taken from the ACQ by an implicit receive 
operation, when needed, to perform an SVL (supervisor 
linkage) instruction (explicit or implicit). A CRE is 
returned by an implicit send to the ACO when the SVX 
(supervisor exit) instruction is issued. The descriptors of 
the ACQ and the SRQ (send/receive queue) are identical 
(if no available CREs are enqueued, descriptor bit 4 = OQ). 
See the SRQ in Chapter 5 for the byte descriptions. All 
send/receive operations involving the ACO must specify 
enqueue first/dequeue first. 


If the ACQ is not resident in storage, is not fullword 


aligned, or crosses a page boundary, a machine check 
will occur when the ACQ is accessed. 
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Supervisor Linkage Table 


The SVL (supervisor linkage) table is located in resident 
storage and consists of 256 4-byte entries. The format 
of each 4-byte entry in the SVL table is as follows: 


Entry 


Address 





0 1 2 Bytes 4 





C 


Bytes 
(Hex) Bits Descriptions 
0 Base: Base registers to be saved. 

0-3 First base register saved. 

4-7 Number of base registers to be saved 
minus 1. The registers saved must 
include B(O). Base register addresses 
wrap around from hex F to zero. 

1 Flag: Flag byte. 
0 O IMP offset in bytes 2 and 3. 
1 HMC CSAR in bytes 2 and 3. 
1 Reserved. 
2 O If not an exception SVL (SVL table 


index = 0), then the SVL procedure 
will be inhibited and the SVL 
instruction will be executed as a 
no-operation. The exception SVL 
(SVL table index = 0) will always be 
executed regardless of the value of 
this bit. 


1 The SVL procedure will be executed 
as described. 


3-7 Reserved. 


2-3 Entry Address: Entry address of SVL 
routine. Bytes 2 and 3 are either an 
offset into the segment identifier of the 
SVL table if Byte 1, bitO =0, ora 
CSAR value if byte 1, bit O = 1. 


All SVLs refer to entries in this table. 


SUPERVISOR LINKAGE CONTROL 
The SVL (supervisor linkage) operation allows: 


e Program to program invocation without explicit 
knowledge of program locations by the invoking 
program. 


e A single, common interface for exception signaling. 


The SVL operation can be understood by considering 
the usage of CREs (call/return elements) for status 
saving and the SVL table for indirect SVL routine entry 
point resolution (see the following diagram). An index 
into the SVL table can be generated either explicitly or 
implicitly, based on the cause of the SVL. Implicit SVLs 
and, therefore, implicit entries into the SVL table, are 
generated by the processor for either trapped 
instructions (using the trapped instruction operation 
code), or for exceptions. Explicitly generated SVL 
instructions use the I-byte of the SVL to index the SVL 
table. The assignment of SVL indexes (binary values) is 
as follows: 


e« All exceptions use SVL table index 0. 


¢« Other implicit SVLs use indexes that do not 
correspond to the basic operation codes or to the 
unused extension fields in those instructions that 
make use of operation code extenders. However, 
operation codes hex OO, 40, and FF are reserved and 
are treated as invalid; operation code OD extended 
with E or F is reserved and will yield unpredictable 
results if executed. An operation exception results if 
execution of one of these operation codes is 
attempted. With this exception, the execution of any 
operation code that is not implemented as a basic 
Operation code results in an implicit SVL operation. 
In this case, the SVL table index value equals the 
operation code. 


¢« Explicit SVLs can use any index value. 
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SVL Table and CRE Usage 





SVL Table 


SVL 
Index F Entry Address Routine 
(see Supervisor 


Linkage, Chapter 2) 






Task Dispatching 
Element 


Requested 
a Registers 


B+1 : 
Register | ) 
eee Information _— 
Ye ee a Available Call/Return Element 
| 

Legend [—ILe (instruction length count) 
—— —-» Information Saved |— CC (condition code) 
——»> Pointers = [AR (instruction address register) 
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The occurrence of an exception results in an SVL unless 
the exception is masked in the TDE (task dispatching 
element) mask field. If the exception is not masked, the 
exception code is stored in the exception field of the 
CRE and the pending exception is cleared in the 
processor. If the exception is masked, the occurrence is 
recorded in bytes hex 1C and 1D of the TDE, no SVL 
occurs, and the pending exception is cleared. 


When an SVL occurs either explicitly or implicitly, byte 0 
of the SVL table entry and the status of the procedure 
are saved in the available CRE. The status includes the 
following: 


e Instruction length count 

e Condition code 

¢« Specified base registers 

e« Exception code 

¢ IAR (instruction address register) 

¢ CSAR (control store address register) 


For an exception SVL in an IMP procedure, the stored 
IAR points to the instruction that caused the exception if 
the instruction was nullified or suspended. Otherwise, 
the stored IAR is the updated address of the next 
instruction to be executed. The CRE is then flagged as 
being in-use and the address of the CRE is loaded into 
base register hex E. In addition, as shown in the 
following table, optional registers are loaded with 
parameters, depending on whether the SVL is implicit or 
explicit and whether zero, one, or two operands are 
present in the SVL instruction. 


SVL Register Loading 


Parameters Loaded 
Implicit Type SVL 
RR (2 bytes) re) [iebytes 


RS, SI (4 bytes, l-byte' First- 
operation codes > or second- 
hex 40, <hex AO) operand 

r(E) address 


SS (6 bytes, r(E) 
operation codes > 


hex AQ) 


First-operand 
address 


Second 
operand 
address 


"In the case of an instruction with an extended operation 
code, the low order 4 bits of the | field contain the 
operation code extender. 





Parameters Loaded 
Explicit Type SVL Parameter 
SVLO": 2 


SVL1": 2 First-operand 
address 


SVL2"- 2 B(1) First-operand 
address 
B(2) Second 
operand 
address 


Address translation | B{1) 
exception 








Faulting virtual 
address 


Virtual address 


All other exceptions [None | 


'B (E) is loaded with the address of the CRE used to save 
status for all SVL types. 
2See Chapter 10 for the format of the SVL instruction types. 


Allocate page frame | B(1) 
exception 
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Effective addresses are calculated and loaded into base 
registers for those SVLs having effective address 
operands. HMC or IMP instruction processing continues 
at the address indicated in the SVL table entry. If bit 0 
of the SVL table flag byte is one, the SVL routine 
address in the table entry is loaded into the CSAR. This 
causes an SVL microprogram indirect branch. If bit O of 
the flag is zero, the halfword address in the SVL table 
entry is an offset into the SID (segment identifier) where 
the SVL table is located. This real address then 
becomes the target of an indirect SVL branch to an IMP 
procedure (register S[O] contains the SID of the SVL 
table, register R[O] contains the SVL entry address, and 
the IAR contains the value that was placed in R[0O]). 


When an SVL is executed, a search of the CRE list 
chained to the TDE is performed. The current status is 
stored in the last available CRE. If there are no available 
CREs on the list, or if the list is empty, a CRE is 
implicitly received from the ACQ (available CRE queue) 
and is enqueued first, when a CRE becomes available, 
on the TDE CRE list. The current status is then stored in 
that CRE. In either case, the status of the CRE is set to 
in-use. 


SVL access exceptions (monitored ACQ, CRE, and TDE), 
associated with the implicit receive operation within an 
SVL, are detected and presented as follows: 


le Busy is ignored and not presented. 


2. If the ACQ and CRE are monitored, these 
exceptions are presented, after completion of the 
implicit receive, in byte O of the exception code in 
the TDE. 


3. Or, if the implicit receive is not satisfied (no CREs 
on the ACQ) and the current TDE is monitored, 
this access exception is reported in byte O of the 
exception code in the TDE. 


Programming Note: When replenishing the ACQ with 
CREs, you should specify send message first in order to 
place the CRE first on the ACQ (busy is ignored by an 
SVL implicit receive). 


For trapped operations (implicit SVLs) and explicit SVLs, 
the original SVL function is nullified (the IAR still points 
to the SVL of the trapped operation code) and the ACQ 
access exception is identified in byte O, bits 5-7 of the 
exception code. If an SVL access exception is detected 
while presenting an exception, the access exception is 
presented concurrently with other exceptions posted in 
byte 1, bits O-7 of the exception code in the CRE. Bit 6 
or 7 of the CRE exception code, byte 0, can be 
presented only after a CRE is received. While the task 
dispatcher is disabled, due to a machine check, the 
function of the exception SVL is altered (as described in 
Chapter 9, under Machine Check). 


If there are no CREs on the ACQ, the implicit receive is 
not satisfied, the TDE for the current task is moved to 
the wait list of the ACQ, and the task dispatcher is 
subsequently invoked. For trapped operations and 
explicit SVLs, the original SVL function is nullified. For 
all exceptions except page fault, the exception code is 
saved in the TDE as part of the task switch. The 
exception is presented again after the ACQ is 
replenished and the task is dispatched. For page faults, 
the exception code and the faulting address are 
discarded. Because the instruction or HMC function 
causing the fault is nullified or marked by a checkpoint, 
the exception is regenerated when the task becomes 
dispatchable and the operation is again performed. If an 
HMC procedure causes an access exception, the queue 
function, the queue header address, and optionally, the 
message or TDE address are saved in the base register 
field of the CRE. The register assignments for the 
values are documented in Chapter 7, under Operational 
Unit Task. The same IMP exception handler is invoked 
for HMC exceptions as for IMP exceptions. The second 
byte of the exception code always contains a value from 
hex OO to 12 or to 1C for HMC procedure exceptions. 
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An explicit SVX (supervisor exit) instruction is used in all 
cases to return from an IMP routine called via the SVL 
instruction. During execution of the SVX instruction, the 
condition code, IAR, or CSAR and base registers are 
restored from the first in-use CRE on the current TDE 
and the CRE status is set to available. The exception 
code and ILC (instruction length count) are not restored 
from the CRE. If the number of available CREs 
encountered before this CRE was equal to or greater 
than the number specified in the control mode field of 
the TDE, the first CRE is returned to the ACQ via an 
implicit send. The CRE is returned to the proper ACQ 
using the ACQ address stored in the CRE. This allows 
gathering of CREs added to the ACQ due to an earlier 
ACQ access exception. The in-use CRE is then used to 
restore status and is flagged available. Note that when 
an SVX is executed, if no in-use CRE is found, or if the 
CRE list is empty, a specification exception occurs. 
Also, descriptor access exceptions are not detected by 
the implicit send when a CRE is returned to the ACQ. 


Programming Note: A minimum of one available CRE is 
always left chained to the TDE by the SVX instruction, 
even if the maximum number is set to zero. 


SUPERVISOR LINKAGE SUMMARY 


Figure 6-1 and the following text summarize an SVL 
operation. Assume that the maximum number of 
available CREs specified in the control mode of the TDE 
is one. 


Gal Procedure Z is being executed and the condition 
of the TDE and the ACQ are as shown below 
the procedure in the figure. 


A condition arises (explicit or implicit) in 
procedure Z requiring an SVL to procedure X. 
At the time of the SVL, since CRE A is in use, 
there are no available CREs on the TDE to store 
the status and base registers of procedure Z. 
Therefore, a CRE (CRE B) is obtained from the 
ACQ and is enqueued to the TDE. The status 
of procedure Z is then saved in CRE B. 


Again an SVL occurs; this time to procedure Y. 
CRE C is obtained from the ACQ, the status of 
procedure X is stored in CRE C, and the 
execution of Y begins. 


4 | Procedure Y is completed and an SVX 
instruction issued. The SVX restores the status 
of procedure X flags, CRE C as available, and 
restarts the execution of procedure X. 


Procedure X is completed and an SVX 
instruction issued. Because an available CRE 
exists on the TDE, the top CRE (CRE C) is 
returned to the ACQ. The status of procedure Z 
is then restored from CRE B, CRE B is flagged 
available, and the execution of procedure Z is 
restarted. 


) 





Start Z 


SVL Table 


SVL X 












Available 





CRE C 







CRE B 


Figure 6-1. SVL Summary 
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Exceptions 


PRESENTATION 


Exceptions can occur during the execution of an IMP 
task. Causes of exceptions include the improper 
specification or use of instructions and data, the 
detection of a page fault, the detection of a program 
event, and task interval timer. Because an exception is 
the direct result of the current task, as opposed to some 
external event, the resolution of the exception is handled 
under control of the current task. The function of the 
exception SVL during the handling of a machine check is 
described in Chapter 9 under Machine Check. 


Exceptions are presented through the use of the 2-byte 
exception code area in the CRE (call/return element). 
The two types of exceptions, concurrent and program, 
and the CRE bytes in which they occur are described in 
the following paragraphs. 


CONCURRENT EXCEPTIONS 


Concurrent exception conditions are presented in the 
first byte of the CRE exception code field. These 
exception conditions are bit significant and can occur 
simultaneously. 


PROGRAM EXCEPTIONS 


Exceptions that result from the execution of IMP 
instructions in an IMP procedure or HMC instructions in 
an HMC procedure are called program exceptions. 
These exceptions include the improper specification or 
use of instructions and data, address translation faults, 
and detection of program events. 


The cause of an exception is identified in the exception 
code field of a CRE (call/return element). The bit 
assignments for this field are described as a part of 
Call/Return Element, earlier in this chapter. 


The exception mask field in the TDE (task dispatching 
element) allows some exceptions to be masked. A 
program exception can only occur when the 
corresponding mask bit is 1. When the mask bit is 0, 
the occurrence of the condition is recorded in the 
exception occurrence field of the TDE but no program 
exception occurs. 


The following paragraphs describe each type of program " 
exception. 2 


Address Compare Exception 


A programmable address compare exception occurs 
when: 


e An address compare for the address and type of 
compare (instruction, |/O, or data) is detected. 


For instruction stream address compare, the instruction 
is nullified. For other types of address compares (data, 
1/O, or other), the instruction or current unit of 
operation is completed. See the SACM instruction in 
Chapter 10 for additional information. 


Address Translation Exception 


An address translation exception (or page fault 
exception) occurs when the processor is unable to 
translate a virtual address into a real address using the 
VAT (virtual address translator) facilities described in 
Chapter 8 because: 


' 
e No primary directory entry exists for the page in the 2 
primary directory. 


e A primary directory exists for the page in the primary 
directory and the valid status bit is set to zero. 


e The index field is zero in the hash table entry. 
The instruction is nullified except for GHRF, GHR, FHRF, 


and FHR instructions. For these instructions the 
instruction is completed. 


Programming Note: When the exception is presented, 
base register 1 contains the faulting address. 


Addressing Exception 
An addressing exception is recognized when: 


e A virtual = real address SID (segment identifier) is 
used that refers tc. a storage location that is beyond 
the range of real storage configured to the processor. 
Such an address is also invalid. 


V=R Address SID Range 
Model (Hex) 


/3,4, and 5 |0000 0100 - 0000 011F 
6, 7, and 8 0000 0100 - 0000 01FF 


The operation is suppressed when the address of the 
instruction is an invalid address. The operation is 
terminated for an invalid operand address. 













Allocate Page Frame Exception 
An allocate page frame exception occurs when: 


e An OU task requests a page frame to be allocated 
and cleared in main storage. 


The instruction is nullified. 

Programming Note: When the exception is presented, 
base register 1 contains the virtual address to be 
associated with the allocated page frame. 

Binary Divide Exception 

A binary divide exception occurs when: 


« The size of the quotient exceeds the size of the 
resultant field in a binary divide operation. 


e Division by zero is attempted during a binary divide 
operation. 


The instruction is suppressed. 


Binary Overflow Exception 

A binary overflow exception occurs when: 

e The carry from the sign-bit position and the carry 
from the high-order numeric bit position do not agree 
during a signed binary add, subtract, or zero and add 


operation. 


« The results of a Convert Packed to Binary instruction 
exceeds 31 bits. 


e Significant bits are lost during a Shift Left Arithmetic 
instruction. 


The instruction is completed. 


Chain Conflict Exception 
A chain conflict exception occurs when: 
¢ A hold conflict is found on an object hold operation. 


e An object free operation attempts to free a monitored 
hold. 


The instruction is nullified but the first-operand base 
register is updated to point at the offending hold record. 
Conversion Exception 

A conversion exception occurs when: 


e The length field of a string control byte is O for a 
CVTMC instruction. 


« The end of source is encountered prior to the end of 
a compression string for a CVTSC instruction. 


« A compression string describes a character string that 
would cross a record boundary in the receiver for a 


CVTSC instruction. 


e The length field of a string control byte is O for a 
CVTSC instruction. 
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Data Exception 

A data exception occurs when: 

e The sign or digit codes of operands in the decimal 
instructions or in a Convert Packed to Binary 


instructions are invalid. 


e The multiplicand in a Multiply Packed instruction has 
an insufficient number of leftmost zeros. 


The instruction is suppressed when a sign code is 

invalid; otherwise, the instruction is terminated. 

Decimal Overflow Exception 

A decimal overflow exception occurs when: 

¢« One or more significant digits are lost because the 
destination field in a decimal operation is too small to 


contain the result. 


The instruction is completed. 


Decimal Zero Divide Exception 
A decimal zero divide exception occurs when: 


e Division by zero is attempted by a Divide Packed 
instruction. 


The instruction is suppressed. 


Descriptor Access Exceptions 
Descriptor access exceptions occur as: 
e« Descriptor access busy (SRQ is in use) 


¢ Monitored (nonzero byte 1) in an SRO (send/receive 
queue) descriptor 


¢ Monitored (nonzero byte 1) in an SRM (send/receive 
message) descriptor 


e Monitored (nonzero byte 1) in a TDE (task dispatching 
element) descriptor 


A descriptor access busy exception occurs when bit 5 of 
descriptor byte 0 is a one during a reference to an SRQ. 
A descriptor access busy exception also occurs during 
object hold/free operations if the hold record chain of 
the object is found to be busy. This bit indicates when 
an access to the object is in progress. The other three 
exceptions (monitored) occur during a reference to an 
IMP object whose descriptor byte 1 does not contain all 
zeros. The particular exception that occurs depends on 
the type of object being referred to. When the 
processor encounters a monitored (nonzero byte 1) SRO, 
SRM, or TDE while executing an instruction, an access 
exception occurs. The instruction causing the exception 
is then suspended, the SRQ is set busy, and the 
checkpoint information is stored in the reserved area of 
the header before the exception is presented. On return 
from the exception handler, checkpoint information is 
restored, busy is reset, and the normal instruction 
execution begins by resuming the suspended instruction. 
For the Receive Message and Dequeue Message 
instructions on an SRM access exception, the element is 
dequeued before the exception is taken. For Send 
Message and Enqueue Message instructions the 
exception is taken before the element is enqueued. 


For Enqueue and Dequeue TDE instructions with a TDQ 
(task dispatching queue) or SRC (send/receive counter) 
as the target, a TDE descriptor access exception does 
not occur. 


J 


J 


The following chart shows the instructions for which 
access exceptions can occur and the sequence (numbers 
1, 2, and 3) of occurrence for each IMP instruction and 
IMP object. 


Sequence 
Instructions SRQ*‘ SRM TDE 


DQM 1 25 

DOTDE 1 25° 
EQM 1 2 

EQTDE 1 2' 
SENDM 1 2 3 
SENDMW 1 2 3 
RECM 1 25 2 
SVLO? 1 2 2 
SVL12 1 2 2 
SVL2? 1 2 2 
SVX? 


'lf the second operand is a TDQ or SRC, no descriptor access 
exception occurs. 

2Descriptor access exceptions are not detected by the implicit 
send when a CRE is returned to the ACQ. 

3The SRM and TDE exceptions are mutually exclusive for a 
Receive Message instruction and an SVL if an implicit 
receive is necessary. 

“The SRQ descriptor byte 0, bit 6 is a summary indicator for 
any TDEs that have monitor bits set and are enqueued to 
the wait list. This bit is not maintained by the processor, but 
is used to test for a TDE access exception on send type 
operations. Therefore, the IMP exception handler is 
responsible for appropriately setting and resetting the bit 
within the exception routine. 

5The SRM or TDE access exception is taken after the 
SRM has been dequeued. 


A TDQ or SRC cannot be set busy or monitored. If 
descriptor bit 5 (busy) or byte 1 (monitored) are nonzero, 
the condition is ignored by the processor. 


The instruction is nullified for SRQ busy and hold free 
chain busy. It is suspended for monitored descriptors of 
SRQ and SRM. 


Note: If the exceptions occur while an SVL instruction 
is being serviced, the exception is reported in byte hex 
74 of the CRE. The instruction causing the exception is 
suspended. 


Edit Digit Count Exception 

An edit count exception is recognized in EDPD when: 

e The end-of-source field is reached and there are 
more control characters corresponding to digits in the 


edit-mask field than in the source field. 


e The end of the edit-mask field is reached and there 
are more digit positions in the source field. 


The instruction is terminated. 


Edit Mask Syntax Exception 

An edit mask syntax exception occurs when: 

e An invalid control character is in the EDPD mask. 
e An end-of-string character is missing. 


The instruction is terminated. 


Effective Address Overflow Exception 

An effective address overflow exception may occur 
when a carry from the offset portion of a virtual address 
occurs during the calculation of a storage operand 
address or a branch address. 


An effective address overflow exception occurs when: 


¢« A carry from bit 24 of a virtual address occurs during 
the calculation of a storage operand address. 


« A storage operand crosses a segment boundary. 


The instruction is suppressed. 
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End-of-Chain Exception 
An end-of-chain exception occurs when: 
e« An empty (null) chain is found on a free operation. 


e An end-of-available (hold record) chain is found on a 
hold operation. 


e No matching hold record is found on a free 
operation. 


The instruction is nullified with the first operand 
unchanged. 

Execute Exception 

An execute exception occurs when: 


e The subject of an Execute instruction is another 
Execute instruction. 


The instruction is suppressed. 


Invalid Descriptor Exception 
An invalid descriptor exception occurs when: 


e An invalid descriptor field is encountered during the 
execution of an operation on an IMP object. 


Whether or not a descriptor type is valid depends on the 
operation being performed. The following chart 
summarizes operations on IMP objects. 


Sa Header Type Element Type 
[Instruction | SRO | ToQ | SRC _| SRM | TDE_ 





[SENDM 
rsenomw |v] 1 | 1 Jv [1 
psenoc | tT tt |v | 


V = Valid 

| = Invalid descriptor exception 
N = Descriptor not checked 

- = No element involved 





Note: An invalid ACQ descriptor encountered by an 
SVL implicit receive or an SVX implicit send causes a 
machine check. An invalid SRM descriptor encountered 
by an SVX implicit send causes a machine check. An 
invalid SRC descriptor encountered by an |/O event 
SENDC causes a machine check. 


The instruction is terminated. 


Floating-Point Inexact Result Exception 


A floating-point inexact result exception occurs if the 
rounded result of an operation is not exact. The result is 
inexact because: 


e One or more bits have been lost in the rounding 
process. 


e A floating-point overflow occurred while the overflow 
was masked, and the result has been set either to 
infinity or to the largest finite number for that specific 
format. 


The setting of the floating-point inexact result mask 
does not affect the result of the operation. The rounded 
or overflowed result is still available in the result 
operand. 

Floating-Point Invalid Operand Exception 

A floating-point invalid operand exception occurs when 
an operand is invalid for the operation to be performed. 
The operand is invalid because: 


e An operand is an unmasked not-a-number. 


e Addition or subtraction of infinity with infinity was 
attempted. 


« Multiplication of zero times infinity was attempted. 


e Division of zero by zero, or division of infinity by 
infinity was attempted. 


The setting of the floating-point invalid operand mask 
affects the result of the operation. 


e If the exception is masked, the result of the operation 
is a masked not-a-number value: 

— If the exception was because of one or more 
operands being an unmasked not-a-number, then 
the resulting masked not-a-number value is set 
with a fraction value equal to the largest 
not-a-number operand fraction value. 

— If the exception was not because of an operand 
being an unmasked not-a-number, then the 
resulting masked not-a-number value is set with a 
fraction value consisting of a 1 in the leftmost bit 
position followed by zeros for the remaining 
fraction bits. 


e lf the exception is not masked, the operation is 
suppressed, and the exception is signaled. 


Floating-Point Overflow Exception 


A floating-point overflow exception occurs if a rounded 
result is finite, but its exponent is too large to be 
represented in the result format. For this exception to 
occur, the exponent must exceed 127 in the short 
format and 1023 in the long format. The setting of the 
floating-point overflow mask affects the result of the 
operation. In addition, the result of the operation 
depends on the rounding mode and the sign of the 
ntermediate result, as follows: 
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Rounding Mode—Toward 







Sign of 
Intermediate 





Overflow 










Sign of 
Overflow Intermediate 
Exception Is: Result Is: 










Note: The modified exponent is set from the overflowed normal biased exponent minus a 
bias adjust of 192 for short format and 1536 for long format. The following summarizes the 
relationship between what would be the overflowed values for the true exponent signed 

exponent, the normal biased exponent, and the modified biased exponent. 


Short Format Long Format 


Overflowed 


Exponent 


Exception Is: Result Is: Positive Infinity | Negative Infinity | Nearest 


Positive To largest positive | To infinity To largest positive | To infinity 
number correctly signed number correctly signed 

Negative To largest To largest To infinity To infinity 
negative number |negative number {correctly signed correctly signed 








Floating-Point Underflow Exception 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. For this 
exception to occur, the exponent must be less than 
-126 in the short format and -1022 in the long format. 
The setting of the floating-point underflow mask affects 
the result of the operation and the setting of the 
occurrence bit. 


e If the exception is masked, the result of the operation 
is produced by first denormalizing the unrounded 
result, then rounding, then putting it in its result field. 
Only when the result is not exact is the underflow 
exception occurrence bit set on. 


e If the exception is not masked, the result of the 
operation is a correctly rounded significant, a correct 
sign, and a modified exponent. The underflow 
exception occurrence bit is set on. The modified 
exponent is set from the underflowed normal biased 
exponent plus a bias adjust of 192 for short format 
and 1536 for long format. This bias adjust is chosen 
to translate underflowed biased exponents as nearly 
as possible to the middle of the representable biased 
exponent range for the short and long formats. This 
allows the exception handler to provide appropriate 
information for later reconstruction of the correct 
result. The following diagram summarizes the 
relationship between what would be the underflowed 
values for the true signed exponent, the normal 
biased exponent, and the modified biased exponent. 


Underflowed | True Normal Modified Normal Modified 
Signed Biased Biased True Signed Biased 


Exponent Biased 


Minimum 126 [nt ft fr 
Maximum |-208 evn zn fata tts at 
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Floating-Point Zero Divide Exception 


A floating-point zero divide exception occurs if the 
divisor is O and the dividend is a finite nonzero number. 
If the exception is masked, the result of the operation is 
a correctly signed infinite value. If the exception is not 
masked, the operation is suppressed. 


Invalid Floating-Point Conversion 


An invalid floating-point conversion exception occurs 
during conversion from floating-point to a fixed-point 
format when overflow, infinity, or not-a-number 
precludes an accurate representation in the fixed point 
format. This exception cannot be masked and has no 
corresponding occurrence bit. The instruction is 
suppressed. 


Invalid Page Exception (Synchronous Requests Only) 

An invalid page exception occurs when: 

e The page does not exist in the segment. The 
segment group exists, but has these properties: (1) 
the size allocated is less than 16 megabytes and (2) a 
reference was made to an address which would have 
been legitimate had the segment been made larger. 
This exception is raised only on Bring and Clear 
(VMC function) and on page faults. 

The instruction is suppressed. 

Invalid Pin Request Exception (Synchronous 

Requests Only) 


An invalid pin request exception occurs when: 


e Pin failed because an attempted pin was the two 
hundred fifty-sixth pin for that page. 


e An unpin was attempted on an unpinned page. 


The instruction is suppressed. 
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Invalid Pool State Exception (Synchronous Requests i 
Only) J 
An invalid pool state exception occurs when: 
« A Bring or Clear (VMC function) with pin cannot be 
performed because too many pages are already 
pinned. 
The instruction is suppressed. 
Invalid Segment Exception (Synchronous Requests 
Only) 
An invalid segment exception occurs when: 
¢« The page does not exist on a Bring and Clear (VMC 
function) or page fault. The requested segment either 


never existed or has been destroyed. 


The instruction is suppressed. 


Invalid Segment Group Address Exception 
An invalid segment group exception occurs when: > 


« The leftmost 3 bytes of the 6-byte virtual address are 
invalid for a BI (Branch Internal) instruction. 


¢ The calculated low-order 3-byte segment group 
address offset is not a positive value or is not 
between a designated lower boundary and 16 
megabytes minus 1 inclusive, for a CAL, CALH, or 
CALHI instruction. 


« An overflow is generated in the intermediate or final 
calculation of an instruction which performs 3-byte 


address arithmetic. 


The instruction is suppressed. 





Invalid Write Request Exception (Synchronous 
Requests Only) 


An invalid write request exception occurs when: 
e A write was requested to a pinned page. 


The instruction is suppressed. 


Length Conformance Exception 
A length conformance exception occurs in EDPD when: 


¢ The end of the edit-mask field is reached and there 
are more character positions in the result field. 


« The end of the result field is reached and there are 
more character positions in the edit-mask field. 


e« The number of hex B2 control characters following a 
hex B1 (floating string) field cannot accommodate the 
longer of the two floating strings. 

A length conformance exception occurs in a CVTMC 

instruction when the converted form of the record is 


larger than the result record length. 


In either case, the instruction is terminated. 


Main Storage Error Exception 

A main storage error exception occurs when: 

e Changed data in main storage could not be accessed 
due to a memory failure. This exception initiates the 
reporting of logical damage. 

The corresponding page on disk is marked logically bad, 

and the instruction is terminated. 


Monitored ACQ Exception 


A monitored ACQ (available CRE queue) exception 
occurs when: 


e An implicit receive operation attempts to take a CRE 
from the ACO when the ACO wait list is empty. 


The instruction is nullified. 


Monitored Call/Return Element Exception 
A monitored call/return element exception occurs when: 


« ACRE is accessed during an SVL (supervisor linkage) 
and there are no CREs available. 


The instruction is nullified. 


Monitored SRM Descriptor Exception 


See Descriptor Access Exceptions earlier in this chapter. 


Monitored SRQ Descriptor Exception 


See Descriptor Access Exceptions earlier in this chapter. 


Monitored TDE Descriptor Exception 


See Descriptor Access Exceptions earlier in this chapter. 


Operation Exception 
An operation exception occurs when: 


e The execution of an instruction with an invalid 
operation code is attempted. 


Operation codes of hex 00, 40, and FF are invalid. The 

instruction is suppressed. 

Page Read Error Exception 

A page read error exception occurs when: 

e A bring (VMC function) or a page fault could not read 
a given page from the disk. This exception initiates 
the reporting of logical damage to the System/38 


instruction set. 


The instruction is terminated. 
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Program Event Monitoring Exception Specification Exception 


A program event monitoring exception occurs when: A specification exception occurs when: 
e Program event monitoring is specified and the e An instruction address does not designate a location 
designated event occurs. on an even-byte (halfword) boundary. 
The instruction is nullified. e An instruction stream crosses a segment boundary. 
The exception is recognized after the execution of an 
See Program Event monitoring in Chapter 9 for a instruction that ends on, but does not cross a 
description of the exception condition. segment boundary. 


Programming Note: Because of a hardware restriction 
Second Chain Search Exception on Models 3, 4, and 5, the last fullword of a segment 
should not contain any portion of an instruction. 
A second chain search exception occurs when: 
e An operand address does not designate an integral 


e The Grant Hold or Free Hold instructions determine boundary in an operation requiring such integral 
that a secondary chain must be searched. boundary designation. 
The instruction is nullified. e A branch, call, or jump address does not designate a 


location on an even-byte (halfword) boundary. 


Send/Receive Counter Overflow Exception ¢ The multiplier or divisor in decimal arithmetic exceeds 
15 digits and sign. 
A send/receive counter overflow exception occurs 


when: e The first-operand field is shorter than or equal to the - 
second-operand field in decimal multiplication or J 
e A carry from the high-order position of the count division. 


field occurs during a send operation. 
¢ No in-use CRE (call/return element) is on the TDE 


The exception cannot be masked and the operation is (task dispatching element) during an SVX (supervisor 

terminated. This exception does not occur for the exit) operation. 

implicit send count operations caused by the event or 

timer functions. e An IMP object used in any queuing operation or a 
key operand in a dequeue or receive type operation 

The instruction is terminated. crosses a page boundary or is not fullword aligned. 


e The second or third operand of a Compute Subscript 
Address instruction is zero. 


e An enqueue or send type operation designates a TDE 
or SRM (send/receive message) that is currently 
enqueued (descriptor bit 5 = 1). 


¢ Invalid | (immediate) field in dequeue, receive, or 
interval timer instructions. 


¢ The source field of an EDPD (Edit Packed Decimal) 
instruction is greater than 31 digits. 
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The current stack entry is not doubleword aligned 
when accessed by the FCN2 instruction. 


The current stack entry is too short for the FNC2 
instruction. 


The address of the FRAT (function routine address 
table) is not halfword-aligned when accessed by the 
FNC2 instruction. 


The first operand address of a CALLI, STST, or LVT 
instruction does not start aligned on a 16-byte 
boundary. 


Both operand addresses of a MVAST instruction do 
not start aligned on a 16-byte boundary. 


The second-operand address of an AHSPOI, AHSPO, 
or AFSPO instruction does not start aligned on a 
16-byte boundary. 


The address of the available hold record does not 
start aligned on a 16-byte boundary for the GHR or 


GHRF instructions. 


In an EPDE instruction the primary directory entry 
specified is for a V=R address. 


In an EPDE instruction the primary directory entry 
specified and its associated virtual address are not on 


the same hash chain. 


In an RPDE instruction the primary directory entry 
specified is not on the specified hash chain. 


The length is negative in a TRIM instruction. 

In an STSOP instruction a binary underflow was 
detected when the space locator was subtracted from 
the address contained in the first operand. 


In a CVTMC instruction the result record length is O. 


In a CVTCM instruction the source record length is O. 


« A source or result field offset is specified beyond the 
end of the related source or receiver operand for a 
CVTCM, CVTMC, CVTCS, or CVTSC instruction. 


« An algorithm modifier other than hex OO or 01 is 
specified for a CVTCM or CVTMC instruction. 


e The length of the first operand as specified in register 
R14, or the length of the second operand as specified 
in register R15 is O for a CVICM, CVTMC, CVTSC, 
or CVTCS instruction. 


« A single mode SCAN is specified and the mode 
control value in byte O of the control operand 
(operand 1) specifies different modes for the base 
string and scan character (bits O and 1 are not equal) 
for a SCAN instruction. 


e Bits hex 2 through 7 of byte O (mode control field) of 
the control operand are not O for a SCAN instruction. 


e A source record length of O is specified, and record 
processing is also specified for a CVTCS instruction. 


e The value of the unconverted source record bytes 
parameter is greater than the source record length for 
a CVTCS instruction. 


e Invalid values are specified in the algorithm modifier 
byte for a CVTCS or CVTSC instruction. 


e A result field record length of O is specified, and 
record processing is also specified for a CVTSC 
instruction. 


e The value of the unconverted result field record bytes 
parameter is greater than the result field record 
length for a CVTSC instruction. 

e The algorithm modifier bit 2 = O (no transparent data 


in source), and transparency conversion status is 
active for a CVTSC instruction. 


¢ The field length of a CVSFB or CVLFB instruction is 
invalid. 


The instruction is suppressed. 
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A specification exception condition associated with (1) 
an SVL (supervisor linkage) implicit receive for a CRE, 
(2) and SVX implicit send of a CRE, (3) a timer event 
SENDC (send count), or (4) an |/O event SENDC causes 
a machine check. 


A specification exception occurs when the Enqueue Task 
Dispatching Element instruction references the TDQ 
(task dispatching queue) or a TDE that is misaligned or 
crosses a page boundary or when the Dequeue Task 
Dispatching Element instruction references a similarily 
invalid TDQ. All other references to an invalid 
(misaligned or page boundary crossing) TDQ or TDE by 
the processor result in a machine check. 


Implicit SVL instructions are indicated in Appendix B. 


Stack Exception 
A stack exception occurs when: 


e A stack operation attempts to add a stack entry 
which extends beyond the stack limit value. 


e An unstack operation attempts to remove the first 
stack entry within the segment of the stack (bit 15 of 
the last halfword of stack header = 1). 


The instruction operation is suppressed. 


Task Interval Timer Exception 

A task interval timer exception occurs if the task interval 
timer is decremented through zero during the execution 
of a timed task. A task interval timer exception causes 
control to be passed to the exception handling routine. 
Verify Exception 


A verify exception occurs when: 


e An LVT, AHSPOI, ASHPO, or AFSPO instruction 
detects an invalid operand. 


The instruction is suppressed. 


INSTRUCTION LENGTH COUNT AND : 
INSTRUCTION ADDRESS REGISTER SETTINGS > 


Program Exceptions and Instruction Length Count 
Settings in Chapter 2 describes, in general, how the ILC 
(instruction length count) and IAR (instruction address 
register) fields of the CRE (call/return element) or TDE 
(task dispatching element) are set after an exception 
occurs. This section provides more detail about how 
certain specific situations are handled. 


The IAR value stored into the CRE or TDE is reduced by 
the value contained in the instruction length register and 
zero is stored into the ILC field of the CRE or TDE for 
the following situations: 


e A programmable address compare exception. 
e An address translation exception. 


¢ A completed implicit or explicit SVL (supervisor 
linkage) that encounters one or more access 
exceptions. 


e Any queuing instruction that encounters an access 
exception. 


e Any of the interruptible operations that are suspended 2 
due to an external interrupt or page fault. The 
interruptible instructions are: 

Dequeue Message 

Enqueue Message 

Receive Message 

Send Message 

Send Message and Wait 

Move Characters Long 

Compare Logical Characters Long 

Edit Packed Decimal 

Trim 

Convert Characters to Multi-Leaving 
Remote Job Entry 

Convert Multi-Leaving Remote Job 
Entry to Characters 

Convert Characters to SNA 

Convert SNA to Character 


¢« An unsatisfied receive for the following operations: 
Receive Count 
Receive Message 
Supervisor Linkage Short 
Supervisor Linkage Single 
Supervisor Linkage Double 


Any of the implicit SVLs ) | 


C 


The ILC field value is made zero and the IAR field value 
is not reduced for the following situations: 


e When a programmable address compare exception 
that is not on the instruction stream occurs, for 
example, data or I/O. 


e When filling the MCLB (machine check log buffer) on 
a soft machine check report. 


e A task interval timer exception occurs. 


e When a task is switched out (except when no CRE 
was available during an exception SVL). In the case 
of an exception SVL with no CRE available, the value 
of the IAR and ILC fields are determined by the type 
of exception that occurred. 


e If in PEM (program event monitor) mode and a PEM 
exception occurs. 


The value of the ILC field is unpredictable in the CRE or 
TDE if a HMC procedure is also indicated in the CRE or 
TDE as follows: 


e When a new task is switched in, the ILC field value is 
loaded into the instruction length register. If no 
program exception is pending, the new task is 
switched in and the IAR is reduced by the ILC prior 
to the execution of the first instruction. When initially 
built, a new TDE should have the ILC initialized to 
zero. 


e When a Supervisor Exit instruction is executed, the 
ILC field value is ignored. If no specification 
exception is detected during execution of the 
Supervisor Exit instruction, the instruction length 
register is made zero; if a specification exception is 
detected, the instruction length register is left as is 
(containing a value of 2) and the exception is 
presented. 
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This chapter describes the interface between IMP-IOM 
([/O manager) tasks, which translate system |/O 
requests into a form recognizable by the |/O channel 
(channel-directed commands), and OU (operational unit) 
tasks, which execute the translated |/O requests within 
the channel. The format and meaning of the information 
passed across this interface is described in detail. 


A general view of System/38 |/O structure is shown in 
the following diagram. The interface under discussion is 
the IMP-channel interface. 


The other levels of interaction are described in the 
Channel Theory-Maintenance manual. 
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The IMP-channel interface is sufficiently generalized to 
allow user to user communications with any source of 
asynchronous events; for example, |/O devices, external 
processors, and operator commands from the system 
console. 


The interface mechanism used for the IMP-channel 
interface is the send/receive queuing structure described 
in Chapter 5. All interfaces are handled by exchanges of 
messages between tasks on send/receive queues. The 
following illustration is an overview of the IMP channel 
interface mechanism. 


lIOM 


(1/O manager task) 





Send 
Message 


Operational Unit Queue 
(commands) 


Message 
List 


TDE List 


Receive 
Message 


Operational 


Unit Task 
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Receive 
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Input/Output Manager Queue 
(responses) 


Message ) 
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Message 
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From the viewpoint of an IMP-IOM task, |/O and other 
asynchronous operations appear similar to any other 
running IMP task. 


Rather than interrupting IMP processing to signal an 
event or condition, all |1/O and/or other asynchronous 
event sources are handled by channel processing 
functions and the OU (operational unit) task. The OU 
task can receive messages, send messages, or both. 


O I 

U O 
IMP-Channel 0 Mi 
Interface 0 


OU Task 1 









HMC Channel 


PS SS a 


External World 


Figure 7-1. System/38 I/O Structure 
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An overview of System/38 |/O structure is shown in 
Figure 7-1. 
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Asynchronous Operations 


Asynchronous I/O operations are requested or enabled 
by IOM (I/O manager)-formed, channel-directed work 
requests contained within an ORE (operation request 
element). An ORE is a part of an SRM (send/receive 
message) in which the text portion has a special 
meaning to |/O OU (operational unit) tasks. The text 
portion of the ORE consists of two fields: 


« A 2-byte OU response field (BSTAT). 


« A 16-byte, |OM-formed, channel-directed command 
OB (operation block). An OB, of which there are five 
types, is, in effect, a channel instruction executed by 
the OU task. 


The OB always has a channel order field executed by 
the OU task and may have a device order field 
containing a specific device command and 
command-related information. The device order field is 
passed to the device for execution. Of the five OB types 
only the FOB (function operation block) contains, in 
addition to the channel order field, the device order 
field. 


Refer to Figure 7-2. An IMP-IOM task can request an 
asynchronous |/O operation by sending an ORE to a 
predefined OUQ (operational unit queue). The OU task 
responsible for servicing the queue receives the ORE, 
initiates the requested action by executing the OB of the 
ORE, and passes any required device command and 
command related information to the device identified in 
the OB. 


An |/O device (or other source of asynchronous event), 


together with the task that controls the device (or 
event), is called an OU (operational unit). 


7-4 


There is one OU task and one pair of queues (OUQ and 
IOMQ) for each OU. 


In general, there is a one-to-one relationship between 
IOMs and OUs. However, a single IOM can serve 
multiple OUs. 


Information about the completion of the requested 
operation is sent back to the IMP-IOM task when the 
OU task places completion status into the 2-byte OU 
response field of the ORE and sends the ORE to an 
IOMQ (I/O manager queue) used as a response queue. 
The IMP-IOM task obtains the information by issuing a 
receive to the IOMQ. 


If a SENDMW instruction was used to send the SRM to 
an QUQ, the OU task places the information about the 
completion of the requested operation into the 2-byte 
OU response field of the ORE. The OU task then 
causes the task, whose TDE address is in bytes hex 
7A-7F or 122-127 of the SRM, to be enqueued to the 
TDQ. It is not necessary for the OU task to issue a 
Send Message instruction or for the IMP-IOM task to 
issue a Receive Message instruction because the TDE 
created the ORE and knows its address. 


The response may indicate successful completion or 
error conditions for a requested operation. 


J 
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ER issues |/O request-send ORE to OUQ. 
Wait for |/O completion—receive from |OM queue. 
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Figure 7-2. Asynchronous Operation Queuing Structure 
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Operational Unit Task 


The OU (operational unit) task uses HMC functions that 
allow an |/O unit to participate in the IMP send/receive 
queuing structure. A single OU task exists for each I/O 
unit, and like an IMP-IOM (I/O manager) task, is 
represented as a separately identifiable unit of execution 
in the machine by a TDE (task dispatching element). 
The OU task competes for the processor with IMP tasks 
and other OU tasks through the priority mechanism of 
the TDQ (task dispatching queue). The IMP facilities for 
virtual addressing, addressing exceptions, message 
queuing, machine check, and task dispatching are 
available to OU tasks. 


The OU task associated with an |/O unit is invoked by 
either a channel-processing function (I/O event handler) 
or an IMP-IOM task. The specific operation performed 
by the OU task is contained in either the ORE (operation 
request element) or an |/O event field located in the 
queue control table event stack of the task. The 
operations involve command completion functions 
(command end and command end-fetch next 
command), execution of OBs (operation blocks) and 

OPs (operation programs), page fault resolution, and the 
modification of addresses contained in |/O resolved 
address registers. 
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The components of an OU task are referred to in the 
following diagram: 


« A set of HMC procedures. 
e Task control information: 
— A QCT (queue control table) that contains task 
control parameters. 
— A QCT event stack that contains |/O event fields 
to be processed by the OU task. 
— An address list containing ALEs (address list 
elements) used in page chaining operations. 
¢« A TDE (task dispatching element). 
The OU task performs: 
»« Execution of OBs and OPs. 


« Command completion functions. 


e Modifications of |/O resolved address registers. 


Operational Unit Task Components 
Task Control Information 


Queue 
Control 
Table 


HMC Procedures 


Address 
List 
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Programming Notes: 

1. Initialization of the task control information is the 
responsibility of the IOM of the OU. 

2. The OU has a base register work area (bytes hex 
32-91 in the TDE}, which must be initialized by the 
IOM of the OU in accordance with the following 























diagram. 
OU Task Base Register Assignment 
Bytes 
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(hex) 
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IMP OBJECTS: THEIR FORMATS AND OPERATION 


The formats and operation of the IMP system objects 
TDQ (task dispatching queue), TDE (task dispatching 
element), SRO (send/receive queue), SRM 
(send/receive message), and SRC (send/receive 
counter), are described in Chapter 5. 


The application of some of the objects in the |/O 
structure and the formats and operational characteristics 
of objects unique to the |/O structure are described in 
the following sections. 


Unless otherwise stated, all unassigned fields in the |/O 


object formats are considered to be reserved and must 
not be used. Such fields should contain zeros. 
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Internal Microprogramming Channel 
Objects 


OPERATIONAL UNIT 


An OU (operational unit) is an |/O object consisting of 
an OU task and the I/O unit (device). 


An OU has a unique byte code descriptor used for |/O 
device addressing by an IOM (I/O manager) task, called 
the operational unit number. The OU number is in all 
OBs (operation blocks) contained in an operation 
program. 


The OU number in the FOB (function operation block) is 
used by the channel to initiate a start device channel 
hardware operation. 


Assignments 


The assignment of OU numbers, channel priorities, and 
|/O resolved address registers for |/O units attached to 
System/38 is controlled via the system configurator. 


Programming Notes: The OU number is a unique, 8-bit 
code. For some |/O devices the code’s format allows 
hardware field-replaceable unit personalization for 
multiple |/O devices of a given type. 


The format of the OU code implemented by |/O 
adapters is: 


ee ee 


0 Bits 2 4 


8 
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Bits Description 
0-1 Modifier: Indicates multiple devices of a given 
type. The 2 bits are hardware programmable at 
the card field replaceable unit level on the |/O 
port. 
0O_—s— First device of a given type. 
01 Second device of a given type. 
10 Third device of a given type. 
11. ~+Fourth device of a given type. 
2-3 Group: A functional group or category of |/O 


devices (magnetic media, card |/0, 
communications, or other). 


00 Group 0 
01 Group 1 
10 Group 2 
11. Group 3 


4-7 Device Code: A specific device address code. 


OPERATIONAL UNIT QUEUE 


The QUQ (operational unit queue) is an IMP 
send/receive queue used to communicate |/O command 
request information to a device OU (operational unit) 
task from an IMP 1OM (I/O manager) task. 


The TDE (task dispatching element) of the OU task is 
enqueued to the OUQ when the OU task is not busy. 


A Send Message instruction issued to the OUQ from an 
IOM procedure will cause the OU task TDE to be 
enqueued to the TDQ (task dispatching queue) for 
dispatching. 


request elements) containing OBs (operation blocks) to 
be processed by the OU task. 


Elements on the OUQ message list are OREs (operation > 


The ORE is obtained by the OU task performing a 
receive message Operation on the queue. The key 
control (search type) and search key used to dequeue 
the ORE are contained in the OU task base registers and 
the queue control table. 


Format: The OUQ header format is the same as an SRO 
(send/receive queue) header with a key length 
specification of 4 bytes. This format is shown in Figure 
7-3 and the description is in Chapter 5. 


Programming Notes: 

1. The QUQ header is fullword aligned and must not 
cross a page boundary. It may be located in any 
virtual or real storage location (subject to the above 
restriction). 

2. The address of the OUQ header and the key control 
used during the receive message operation is 
provided in the base registers of the OU task. Note 
that the fields must be initialized before an |IOM 
procedure issues a Send Message instruction to the 2 
queue. 

3. The 4-byte search key used by the OU task to 
dequeue an ORE during the receive message 
operation is in the queue control table. Note that the 
field must be initialized before a Send Message 
instruction is issued by an IOM task. 

4. The key length of all elements on the OUQ is 4 
bytes. One OUOQ exists for each OU task in the 
system. 


Descriptor First TDE Address 





0 Bytes 2 





Reserved Key First Message Address 
Lth-1 
8 9 A Bytes 
Reserved 
10 Bytes 
Reserved 
18 Bytes 


20 


Figure 7-3. 1/O Manager Queue, Operational Unit Queue and Send/Receive Queue Headers 


[/O MANAGER QUEUE 


The IOMQ (I/O manager queue) is an IMP send/receive 
queue used to communicate |/O command response 
information to an IOM (I/O manager) task from a device 
OU (operational unit) task. Elements on the |IOMQ 
message list are OREs (operation request elements) that 
have been processed by the OU task and contain 
command completion status. The completed elements 
are enqueued on the list by the OU task performing a 
send message operation. 


The position of the ORE on the message list is 
determined by the key field in the ORE and the key 
control used for the send message operation. 


If the TDE (task dispatching element) of an IOM task is 
enqueued to the I|OMO wait list, it is enqueued to the 
TDQ (task dispatching queue) when the OU task 
performs the send message operation. 


Format: The IOMQ is an SRQ (send/receive queue) 
with a key length specification of 4 bytes. This format is 
shown in Figure 7-3 and the description is in Chapter 5. 


Programming Notes: 

1. The IOMQ header must be fullword aligned and must 
not cross a page boundary. It may be located in any 
virtual or real storage address. 

2. The address of the IOMQ to be used by a OU task is 
contained in the base registers of the OU task. Note 
that the address must be initialized before any Send 
Message instructions are issued to the OUQ serviced 
by the OU task. 

3. The key length specification of all elements on the 
IOMQ is 4 bytes. In general, one I|OMQ will exist for 
each IOM task in the system. 
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OPERATION REQUEST ELEMENT 


The ORE (operation request element) is an IMP 
send/receive message element used to communicate 
|/O command and response information between an 
IOM \!/O manager) procedure, and an OU (operational 
unit). As illustrated in Figure 7-2, the ORE is formed 
and enqueued to the OUO (operational unit queue) by 
the IOM procedure sing a Send Message instruction 
(label 1 in the figure). The Send Message instruction 
contains both the OUQ header address and the address 
of the ORE to be enqueued. 


The OU task removes each ORE from the OUQ by 
performing a receive message operation. The address of 
the dequeued ORE is contained in the OU task base 
registers during the processing of the operation blocks 
contained in the ORE (label 3 in Figure 7-2). 


When all operation blocks in the ORE have been 
processed by the OU task and its associated |/O device, 
the ORE, containing command completion status, is 
enqueued to the I|OMQ by a send message operation 
performed by the OU task (label 7 in Figure 7-2). 


Note: The ORE is not physically moved in main storage 
during the above operations. The ORE is enqueued and 


dequeued from the OU and IOM queues through the 
manipulation of addresses. 


Format: 


Descriptor Next Message Address 





0 Bytes 2 


OU Status 
(BSTAT) 


Reserved 





8 Bytes Cc E 







Operation Block 


10 Bytes 20 


Bytes 
(Hex) Bit Description 


0-1 Descriptor: The object descriptor for 
an SRM (send/receive message) 
element. See Chapter 5 for the SRM 
bit description. 


2-7 Next Message Address: The virtual 
address of the next ORE in a list, when 
the ORE object is enqueued on an OU 


or IOMQ. 

8-B Key: The value used to enqueue and 
dequeue the ORE from the OU and 
IOM queues. 

C-D Reserved: Must be zeros. 

E-F OU Status (BSTAT): OU status 


information for the IOM procedure that 
initially issued the ORE. The OU status 
may be formed by either the device 
adapter or OU task. Excluding the 
operation program error status provided 
by the OU task, the OU status field is 
updated for each FOB (function 
operation block) executed in an ORE. 


The usage of each status bit is described below. 


Bytes 
(Hex) Bit Description 
E 0 Reserved: Must be zero. 
1 Operation Program Error: Is set when 


an error condition is detected during 
the processing of OBs (operation 
blocks) by the OU task. The specific 
type of error is indicated in byte hex F 


of the ORE. 
2-3 Reserved: Must be zeros. 
4 |/O Exception: Is set to indicate a 


device exception condition during the 
execution of an FOB command by a 
device adapter (the |/O exception may 
be suppressed if command complete 
bit is also set). 


Bytes 
(Hex) Bits 
E 5 

6 

7 
F 0-7 
10-1F 


Description 


Command Reject: Is set when a device 
adapter detects an invalid command or 
is in a state that prevents execution of 
the FOB command. 


|/O Error: Is set when a device 
dependent error condition is detected 
during execution of an FOB command. 


Command Complete: Is set when an 
FOB command has been executed to 
successful completion by the OU. 


OU Status: May contain either device 
dependent status provided by the |/O 
device at the completion of a FOB 
command or an OP (operation program) 
error provided by the OU task. Use of 
this byte is optional and device 
dependent. 


Operation Block: Can contain one of 
the following operation blocks: POB 
program operation block), FOB 
(function operation block), AOB 
(address operation block), or MOB 
(message operation block). A fifth 
operation block, the LOB (loop 
operation block), may not appear in an 
ORE. 


Descriptions of the operation block 
formats and their operations are 
provided under Operation Blocks in this 
chapter. 


Programming Notes: The ORE must be doubleword 
aligned and may not cross a page boundary. It may be 
located at any virtual or real address. 
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OPERATION BLOCKS 

The OBs (operation blocks) contain command requests 
to an OU (operational unit) from an IOM (I/O manager) 
procedure. The OBs are included in an ORE (operation 
request element) and are processed by the OU task of 
the OU. 

The five OB types are: 

¢ POB (program operation block) 

« FOB (function operation block) 

« AOB (address operation block) 

e« LOB (loop operation block) 

e MOB (message operation block) 

The formats and operations of the five OBs are 


described in the following sections. 


Formats: The OB is a 16-byte object that must be 
aligned on a doubleword boundary, and may not cross a 
page boundary. 


As indicated in the first diagram, byte O contains a type 
code to indicate the specific OB. Byte 1 contains control 
information used by the OU task during the execution of 
the OB. The type code and control bit assignments for 
each OB type are shown in the second diagram. 
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Operation Blocks: Types and Control Information. 
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Types of Operation Blocks 


Program Operation Block 


The POB (program operation block) specifies that a 
sequence of OBs (operation blocks) are to be executed 
by the OU (operational unit) before the ORE (operation 
request element) is returned to the IOM (I/O manager) 
program. The OBs associated with the POB are referred 
to as an operation program. 


A POB contains the address of the first OB in the 
Operation program and the address of the current (or 
last) OB in the operation program processed. 


During the processing of OBs, the address of the 
current OB is maintained in bytes 2-7 of the POB and 
the current OB address field is incremented by 16 as 
each OB in the program is processed. The LOB (loop 
operation block) may be used in the operation program 
to modify the current OB address nonsequentially. 


At the successful completion of an operation program, 


the current OB address field contains the address of.the 
last OB processed. 


Format: 


Type 


D7 Control Current Operation Block Address 





0 1 2 Bytes 


Reserved Operating Program Address 





8 9 A Bytes 10 





Bytes 

(Hex) Description 

0 Type: POB type code (hex D7). 
1 Control: Control field (hex OO). 


2-7 Current OB Address (virtual address): The field 
must be initialized with the address of the first 
OB to be executed in the operation program. 


Following successful execution of the operation 
program, the field contains the address of the 
last OB processed. If the operation program is 
terminated due to an error, the field contains 
the OB address in process when the error was 


detected. 
8 QU: A valid OU (operational unit) number. 
9 Reserved: Must be zeros. 


A-F Operation Program Address: Virtual address 
of the first OB (operation block) in the operation 
program. The field is not modified during the 
operation program. 


Programming Notes: 

1. The POB must be aligned on a doubleword address 
boundary, and may not cross a page boundary. It 
may not be imbedded in an operation program. 

2. The current OB address field does not have to be the 
address of the first OB in the operation program. 


Function Operation Block 


The FOB (function operation block) conveys command 
information to an |/O device attached to the channel. 
The FOB may be contained in an operation program. 


The virtual storage address used by the |/O device 
during execution of the FOB command is provided by 
the data address field and the control field as follows: 


e If the control field indicates that page chaining is not 
used, then the data address field of the FOB contains 
the |/O address to be resolved and loaded into the 
data |/O resolved address register of the device. 


e If page chaining is used during the data transfers, the 
data address field contains the address of a stack of 
ALEs (address list elements). 


Bytes hex 8-15 of the FOB provide command 
information to the |/O device and optionally provide 
status from the device following execution of the FOB 
command. 
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Format: 








Bytes 
(Hex) 


0 


Bits 


Data Address 


2 Bytes 


Command/Response 


A Bytes 


Bytes 
Description (Hex) 
Type: FOB type code (hex C6). 
Control: Control field. 


End-of-Operation Program: Is set to 
one if the FOB is the last OB in an 
Operation program; otherwise is zero. 


Reserved: Must be zeros. 


Set Data Address: When set, causes a 
virtual address to be resolved and 
loaded into the I/O resolved address 
register specified by the data register 
field of the QCT (queue control table). 
The actual address to be resolved is 
determined by the page chaining bit. 


Page Chaining: If the page chaining bit 
is set, when the set data address bit is 
set, then the I/O address to be 
resolved and loaded into an I/O- 
resolved address register is located in 
an ALE (address list element) 
addressed by the data address field of 
the FOB. 


Description 


Load-Unique |/O RAR (resolved 
address register): 


When the load-unique |/O RAR bit is 

set simultaneously with the set data 

address and page chaining bits, it 

indicates that the data address in the 

first ALE stack entry will be resolved 

and loaded into the I/O resolved | 
address register specified by the CMD J 
REG field of the queue control table, 

plus one. When the unique |/O RAR 

is loaded into the specified CMD REG 

field, HMC interrogates byte 9, bit 1 

and byte hex A. If byte 9, bit 1 is zero 

and byte A does not equal hex 01, then 

the unique register is marked invalid 

and the store allowed bit in the QCT is 

set. 


After loading the unique |/O resolved 
address register, the OU task will load 
the address of the second ALE stack 
entry into the OCT ALE pointer field. 
When the I/O adapter transfers a 
load-multiple |/O register function 
event to the channel, the |/O event 
handler will load ALE data addresses 
into consecutive |/O resolved address 
registers, starting with the data register 
specified in the QCT. The unique |/O 
RAR is marked valid and the store 
allowed bit is set or reset to reflect the 
state of the store allowed bit in the 
QCT. 


Reserved: Must be zero. J 


C 


Bytes 
(Hex) 


2-7 


Bits 


0-4 


Bytes 
Description (Hex) Bits 
Data Address: Either an |/O address A-F 
or the address of the first ALE (address 
list element) of a page chain address 
list if the set data address bit is set. 
The field should contain zeros if the set 
data address bit is zero. If page 
chaining is used, then the address must 
be virtual = real. 


OU: A valid operational unit number. 


Command: An |/O command code to 
be interpreted and executed by the |/O 
device. The format of the CMD field is 
as follows: 


Device Dependent Control: A device 
dependent command code defined by 
each device adapter. 


Control: An |/O command that may or 
may noi involve a data transfer to or 
from) main storage. 


Read: An 1/O command that involves 
a data transfer from an I/O device to 
main storage. 


The change bit in the primary directory 
entry (bit 42) for the page to be 
resolved is set to the value of the read 
bit when the set data address bit (byte 
1, bit 4) of the control field is set. 


Write: An |/O command that involves 
a data transfer from main storage to an 
1/O device. 


Note: The contents of bits 5-7 are not 
recognized by horizontal microcode. 


Description 


Command/Response: Provides 
command information to the device and 
optionally provides extended response 
status from the device. 


Two formats of the 
command/response field are defined in 
the following diagram. Implementation 
of the field format is command 
dependent with only one format valid 
per FOB. 


The basic format provides 6 bytes of 
device /command dependent 
information in addition to the OU field 
and the CMD field (see the following 
diagram). The second 

command /response format provides 2 
bytes of device/command dependent 
information (bytes hex A and B) and 4 
bytes of response status referred to as 
FSTAT (functional status). 


The definition of FSTAT is 

device /command dependent (see 
Chapter 9) and may be used by the 
device to provide command completion 
status in addition to the completion 
status provided in the OU status field 
of the ORE (cperation request element). 
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Formats: 


FOB Command/Response Fields (Bytes 8-F) 
Format 1 


Device Command Dependent 





8 9 A Bytes 
Format 2 


Device/Command 


Dependent 





8 9 A Bytes C 


Note: Unused portions of the command/response 
field should be filled with zeros. 


Programming Notes: 

1. The FOB must be aligned on a doubleword address 
boundary and may not cross a page boundary. 

2. The |/O data address provided in either the data 
address field or an ALE (address list element) must 
be aligned on a doubleword address boundary. 

3. The addresses in the ALE stack (page chain address 
list) must be virtual = real if the load unique |/O 
register bit is on. 

4. Unused portions of the command/response field 
must be filled with zeros. 

5. The address of the page chain address list (ALE 
stack) must be virtual = real. 


Address Operation Block 


The AOB (address operation block) provides the ability 
to save, modify, or load the |/O resolved address 
registers during the processing of an operation program. 


The operation of the AOB is controlled by bits 4-7 of 
the control field. Proper settings of the control bits 
provide the ability to perform selected portions of a 
read, modify, and store cycle. The control bits provide 
the ability to load the address contained in the |/O 
resolved address register into the AOB, modify the 
address in the AOB, and to resolve the address 
contained in the AOB and load the selected |/O 
resolved address regiscer. 


The |/O resolved address register involved in the AOB 
operation is selected by adding the register modify field 
(byte hex A) in the AOB to the data register field (byte 
3) of the QCT (queue control table). The register modify 
field is treated as an unsigned logical quantity. For 
example, if the data register field in the QCT of the 
operational unit task contains hex 10, then a register 
modify field value of hex 01 in the AOB would result in 
the selection of |/O resolved address register hex 11. 


When an address in the AOB is resolved and loaded 
into an |/O resolved address register, the change bit in 
the page directory entry for the virtual page is set to the 
value of the read bit in the command field. 





Format: 


Modify 
Address 


Data Address 





2 Bytes 6 





8 9 
Bytes 
(Hex) Bits 
0 
1 
0 
1-3 
4 


Register Address 
Modify nee Modifier 
A B Bytes E 10 
Bytes 
Description (Hex) Bits 
Type: AOB type code (hex C1). 5 


Control: Control field. 
End Of Operation: 


O AOB is not the last OB (operation 
block) in an operation program. 


1 AQOB is the last OB in an 
operation program. 


Reserved: Must be zeros. 


Save Data Address: Causes the offset 

portion of the virtua! address contained 

in the selected |/O resolved address 6 
register to be loaded into AOB bytes 

6-7. The SID (segment identifier) 

portion of the virtual address must be 

preloaded into AOB bytes 2-5 by the 

associated |OM. The save operation is 7 
performed prior to any address 

modifications (modify address control 

control bit) or address resolution (set 

data address control bit). 


Description 


Modify Address: When set, causes the 
address contained in AOB bytes 6-7 to 
be modified by the value specified in 
AOB' bytes hex E-F (address modifier 
field). The address modifier field is an 
unsigned logical quantity and can either 
be added or subtracted from the 
address according to the value of the 
decrement bit. Any carry or borrow 
generated during the modification is 
indicated as an operation program 
error. 


Bytes 2-5 of the AOB are not affected 
by the address modification. 


Decrement: When set, causes the 
address modification specified by the 
modify address bit to be an unsigned 
subtraction. 


Set Data Address: When set, causes 
the address in AQB to be resolved and 
loaded into the selected |/O resolved 
address register. 
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Bytes 
(Hex) Bits 


2-5 


6-7 


E-F 


Description 


Data Address: The SID portion of a 
virtual address used during an AOB 
operation. 


Modify Address: The offset portion of 
a virtual address used during an AOB 
operation. 


OU: A valid operational unit number. 


Command: Provides control for setting 
the change bit in the PD (primary 
directory) entry for the virtual address 
that is resolved and loaded into an I/O 
address register. The byte is formatted 
like the command field of the FOB 
(function operation block); however, 
only the read bit (bit 6) is used during 
the processing of the AOB. If a set 
data address operation is selected, the 
change bit in the PD entry for the 
virtual address is set to the value of the 
read bit in the command field. 


Register Modify: An unsigned logical 
quantity used to generate the effective 
|/O resolved address register number. 
For V=V data address the maximum 
value of the Register Modify field is 
hex OE. A value greater than hex OE 
will generate an operation program 
error. For V=R data addresses the 
value contained in the Register Modify 
field is not constrained. 


Reserved: Must be zeros. 
Address Modifier: An unsigned logical 


quantity used to modify the address in 
the AOB data address field. 


Programming Notes: 


1. 


The resultant virtual address in the data address field 
of the AOB must be aligned on a doubleword 
address boundary. On an AOB read (save data 
address) only the offset is obtained from the |/O 
register. Programming must supply the SID (segment 
identifier) in bytes 2-5 of the AOB and may have to 
supply the offset value. 


. The operations selected by the control bits in the 
control field are performed in the following sequence: 


a. Save data address 
b. Modify address 
c. Set data address 


. An operation program error (described later in this 


chapter) occurs if the selected register number 
exceeds the number of |/O resolved address 
registers available on the system (see //O Resolved 
Address Registers in this chapter). 


. An operation program error occurs if the register 


modify field value is greater than hex OE and the 
address in the data address field is not V=R. 


. An operation program error will be indicated if the 


modified address crosses a segment boundary. 


. If the AOB read/modify/write or read/write is to be 


done, then the 4-byte SID of the address to be read 
must be supplied by the user generating the AOB. 


. An operation program error will be indicated if the 


decrement bit is on while the modify bit is not on. 


> 


J 





Loop Operation Block 


The LOB (loop operation block) helps provide sequence 
control of the operation blocks in an operation program. 


Each time the LOB is encountered during the execution 
of an operation program, the count field of the LOB is 
incremented by 1 and compared to the contents of the 
limit field. If the modified count ts less than the limit 
value, then the next OB (operation block) to be 
processed by the OU (operational unit) task is located by 
subtracting the offset field from the current OB address 
field of the POB (program operation block) in the ORE 
(operation request element). 


If the modified count field equals or exceeds the limit 
value, then the count field is set to zero and the next 
sequential OB in the operation program is executed. If 
the limit field is initially zero, the LOB is treated as a 
no-operation and the next sequential OB is executed. 


If an operation program containing an LOB terminates 
before completion, the count field in the LOB will 
contain the number of times the OB loop was executed 
before the error situation was detected. 


Format: 


Reserved Offset 





0 1 2 Bytes 6 





8 9 Bytes Cc E 10 
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Bytes 
(Hex) 


0 


E-F 


Bits 


1-7 


Description 

Type: LOB type code (hex D3). 
Control: Control field. 
End-Of-Operation Program: 


O LOB is not the last OB in an 
operation program. 


1 LOB is the last OB in an 
Operation program. 


Reserved: Must be zeros. 
Reserved: Must be zeros. 


Offset: Used to modify the current OB 
address field in the POB. The offset 
value is the number of OBs in the loop 
multiplied by 16. 


OU: A valid operational unit number. 
Reserved: Must be zeros. 


Count: The number of times the LOB 
has been processed. The count field is 
set to zero when the count equals or 
exceeds the limit value. 


Limit: The number of times the OB 
loop is to be processed. The limit field 
is not modified by the OU task. 


Programming Notes: 

1. An operation program error occurs if the modified OB 
address is less than the operation field in the POB. 

2. The LOB may not appear in an ORE (operation 
request element). 

3. If the LOB is the last OB of an operation program, 
the program is not completed until the count of the 
LOB equals the limit value. 


Message Operation Block 


The MOB (message operation block) causes an IMP task 
or an OU (operation unit) task to become dispatchable 
during the execution of an operation program. This 
facility can be useful in prefetching, for example, items 
such as virtual storage pages and data translation 
operations. 


If the message bit of the MOB is set, then an implicit 
Send Message instruction is performed by the OU task 
processing the MOB. The Send Message instruction 
causes the SRM (send/receive message) element whose 
address is specified by the message address field of the 
MOB to be sent to the SRQ (send/receive queue) 
designated by the address contained in the target 
address field. Any TDE (task dispatching element) on 
the SRO wait list is enqueued on the TDQ (task 
dispatching queue) as a result of the operation. 


If the message bit is reset, then an implicit Send Count 
instruction is performed with the address of the SRC 
(send/receive count) provided in the target address field 
of the MOB. 








Format: 


Target Address 





0 1 2 Bytes 


Reserved Message Address 





8 9 A Bytes 
Bytes 
(Hex) Bits Description 
0 Type: MOB type code (hex D4). 
1 Control: Control field. 

0 End-Of-Operation Program: 


O The MOB is not the last OB 
(operation block) of the operation 
program. 


1 The MOB is the last OB of the 
operation program. 


1-3 Reserved: Must be zeros. 
4 Message: 


O A Send Count instruction is to be 
performed. 


1 A Send Message instruction is to 
be performed. The address of the 
SRM element to be used in the 
Send Message instruction is 
provided in the message address 
field. 


5-7 Reserved: Must be zeros. 


10 


Bytes 
(Hex) Bits Description 


2-7 Target Address: The virtual address 
of the SRO (send/receive queue) or 
SRC (send/receive counter). 


8 OU: A valid operational unit number. 
9 Reserved: Must be zeros. 
A-F Message Address. 


Programming Notes: 

1. Depending on the priorities of the TDEs (task 
dispatching elements) placed on the TDQ (task 
dispatching queue), a task switch can occur following 
the execution of the MOB by the OU task. When the 
OU task that issued the MOB again becomes the 
current task, the processing of the operation program 
will resume with the OB following the MOB. 

2. The key control (search type) used during a Send 
Message instruction is contained in the OU task base 
register. 
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Operation Program 


An operation program consists of one or more OBs 
(operation blocks) associated with a single ORE 
(operation request element). The OBs of the 
rwnoperation program are processed to completion by 
the OU (operational unit) task before the ORE is 
returned to the IOM (I/O manager) task (via the 1/O 
manager queue). The operation program can contain 
FOBs, AOBs, MOBs, and LOBs. 


The LOB (loop operation block) is used to modify the 
current OB address in the POB (program operation 
block) during OU task execution, providing the capability 
for nonsequential execution of OBs. 
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Operation Program Example ) 


The following example shows how different types of 
operation blocks can be combined to form an operation 
program. The example is a printer operation program. 


An IMP task uses a send instruction to enqueue OREs 
to the OUQ (operational unit queue) of the printer. This 
OUQ is associated with a single OU (operational unit), 
for example, a printer and control adapter. The first 
ORE on the queue contains an FOB (function operation 
block) that causes the printer to restore and print a 
single line. At the completion of the operation, the OU 
task notifies the IMP task by placing a status byte in the 
ORE and issuing a Send Message instruction to send 
the entire ORE to the OU IOMQ (I/O manager queue). 
The IOMQ is not shown in the example. 





f Example of a Printer Routine 
| sro | First TDE Address iff First Message Address 


Reg 

Send 
| Save 
Oe oe 
ea 
rosfE | foul | enore 


The print program: 
@ Prints three lines 


@ Indicates to a target queue each time a line is 
printed via an MOB 
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Programming Notes: 

1. The OBs (operation blocks) of the program must be 
aligned on contiguous doubleword address 
boundaries. 

2. The operation program can be located at any virtual 
(or virtual = real) address, subject to the above 
consideration. The operation program can not cross a 
segment boundary. 

3. The last OB of the program must have the end of 
operation program bit set. If an LOB (loop operation 
block) is the last OB, then the program will not 
complete until the value of the LOB count field is 
equal to the value of the LOB limit field. 
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QUEUE CONTROL TABLE 


The QCT (queue control table) is an OU (operational 
unit) task control object used by the IOM (I/O manager) 
procedure, the OU (operational unit) task receiving OREs 
(operation request elements) from an OU queue, and the 
|/O event handler. A QCT must exist for each OU task 
in the machine. 


The QCT contains an SRC (send/receive counter) object 
used by the |/O event handler routine to dispatch an 
OU task and certain physical parameters associated with 
the particular |/O device. Certain fields of the QCT are 
used by the OU task during the processing of operation 
blocks in an ORE. 


The device |OM task can access the QCT to modify 
certain parameters used by the OU task and I/O event 
handler. 


> 


Format: 





QCT Entry 
ca Data 
Type Control | mand Peates Event Count 
D8 Register ala 
0 1 2 3 4 Bytes 6 


Current ALE Address 


Event Offset 


SRC 
Descriptor 





A Bytes 10 


First TDE Address 


SRC Count 


Event Limit 


SRC Limit 





12 Bytes 18 


FOB Timer 


Count 


FOB Timer 
Limit 


1A 





QCT Event Stack Entry 


1/O Event 


6) Bytes 4 
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Bytes 
(Hex) 


0 


Bits 


Bytes 
Description (Hex) Bits 


Type: OCT type code (hex D8). 1 (cont) 3 


Control: Control field. 
Lock: 


O The I/O event handler does not 
post any event field directed to 
the QCT to the channel IOM 
QCT. 


1 The I/O event handler posts any 
event field directed to the QCT to 
the channel |OM QCT. 


The bit is set by the event handler if 

the QCT event stack is full and is 

set by a device IOM task when any 4 
fields in the QCT are being modified. 


Chain Address: Set by the OU task 
during the processing of the FOB 
(function operation block) with both set 
data address and page chaining bits 
set. The bit, when set, causes the 
event handler to obtain the virtual 
address to be resolved from an address 
list during the servicing of an address 
event. 


FOB In Progress: 


O A command has not been issued 
to an |/O adapter. 


1 A command has been issued to 5-7 
an |/O adapter. 


This bit is set when an FOB is 
issued to an |/O adapter and reset 
when the I/O adapter responds with 
a command end or a command 
end/fetch next command. 


Description 
FOB Timing In Process: 


O VMC does not reset the FOB 
timers. 


1 If this bit is set and the 
FOB-in-progress bit is reset, 
the VMC resets the FOB 
timers. 


This bit is set by VMC to indicate 
that VMC has updated the FOB 
timers. This bit is reset by the OU 
task when the |/O adapter issues a 
command end or a command 
end/fetch next command. 


Store Allowed On Data Registers: 
O Store not allowed. 


1 When an I/O adapter requests 
a load multiple |/O register 
function, the store allowed bit 
is set in the |/O data register. 
This allows the |/O adapter to 
transfer data into storage. 


2 


This bit is set when the OU task 
processes the FOB if bit 6 of the 
FOB command field is set. This bit 
is reset when the I/O adapter 
responds with a command end or 
command end/fetch next command. 


Reserved: Must be zeros. 


Command Register: The address of 
the |/O resolved address register used 
by a device to access bytes hex 8-F of 
the FOB. Each device on the system 
must have an assigned command 
address register. 





C 


Bytes 
(Hex) 


3 


6-7 


8-9 


Bits 


Bytes 
Description (Hex) Bits 
Data Register: The address of the 10-1B 
primary data address register used by 
the |/O device. If more than one data 
address register is required by the 
device, the data register byte contains 
the address of the lowest numbered 
register assigned to that device. 


If the device does not require any data 
address registers, the data register field 
must be the same as the command 
register field. 


Event Count: The number of events in 
the QCT event stack. This field is 
incremented by the event handler when 
event fields are placed on the QCT 
event stack. 

Event Offset: The address offset, 1C-1F 
within the same QCT segment, to the 
beginning of the QCT event stack. 
Event Limit: The number of 4-byte 20-21 
event entries that can be put into the 

QCT event stack. 


Current ALE Address: A virtual = real 
address to an ALE (address list 
element) in a page chain address stack. 
The address is valid only during the 
execution of an FOB in which page 
chaining is used. 


22-23 


This field is modified by the event 
handler as each address is obtained 
from the page chain address list. 


Description 


Send/Receive Counter: Controls the 
dispatching of the OU task. The OU 
task issues a Receive Count instruction 
to increment the count of the SRC; the 
event handler issues a Send Count 
instruction. 


SRC fields are: 


Hex Byte Contents 

10-11 SRC descriptor 
12-17 First TDE address 
18-19 SRC count 
1A-1B SRC limit 


Key: The search key operand during 
the Receive Message instruction 
performed by the OU task. 


FOB Timer Count: Time elapsed for 
current FOB in n-second increments; 
maintained by VMC (vertical 
microcode). 


FOB Timer Limit: Timing !imit for FOB 


in n-second increments; maintained by 
VMC. 
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Programming Notes: 

1. The QCT (queue control table) must be in V=R (virtual 
= real) storage and doubleword aligned. The QCT 
must not cross a segment boundary. The QCTs for 
all OU (operational unit) tasks must be in the same 
V=R segment. 

2. Certain fields in the QCT must be initialized by the 
IOM (I/O Manager) of the OU prior to dispatching 
the OU task. All fields except the following should be 
initialized to zeros. 

a. Type (byte 0): Set to the QCT type code of hex 
D8. 

b. Cmd Reg (byte 2): Set to the address of the 
command address register for the device. 

c. Data Reg (byte 3): Set to the address of the data 
address register for the device. If no data address 
registers are required, the byte must contain the 
command address register number (same as byte 
2). 

d. Event Offset (bytes 6-7): Set to the address, 
within the segment, of the first byte of the QCT 
event stack. 

e. Event Limit (bytes 8-9): Set to the number of 4 
byte event fields allocated in the QCT event stack. 
The limit value must be greater than or equal to 


four. 

f. SRC Descriptor (bytes hex 10-11): Initialized to 
hex 8000. 

g. SRC Limit (bytes hex 1A-1B): Initialized to hex 
0001. 


h. Key (bytes hex 1C-1F): Initialized to the key value 
used to dequeue OREs (operation request 
elements) from the OUQ (operational unit queue). 

3. The IOM may modify QCT entries only if the OU task 
is on the wait list of either the OUQ or the QCT—SRC 

(send/receive counter) of the OU task. 
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QCT EVENT STACK 


The QCT (queue control table) event stack contains |/O 
event fields to be processed by the OU (operational unit) 
task. The event fields are placed on the stack by either 
the IOM (I/O manager) task or the event handler and 
are removed and processed by the OU task in a first in, 
first out manner. 


The event offset field of the QCT provides the offset 
address to the beginning of the stack. The event limit, 
event count, and SRC count fields of the QCT are used 
by the event handler and OU task when posting or 
removing fields from the stack. 


Although the event fields are normally placed on the 
QCT event stack by the event handler; an |/O manager 
task, under certain circumstances, can place an event 
field on the stack prior to dispatching the OU task. 


The [OM must perform the following steps to place an 
entry on the stack or modify the QCT: 


1. Set the lock bit in the control field of the QCT, to 
prevent the event handler from posting an event 
while the [OM is modifying the QCT fields. 


2. Test for open entries in the event stack field of the 
QCT. 


3. If the event count equals the event limit, reset the 
event count to hex OOOO. 


4. Place the 4-byte event field on the event stack at 
the address equal to the event offset + four times 
the event count. 


5. Increment the event count field by one. 

6. Reset the iock bit to zero. 

After the above steps are completed, the OU task is 
dispatched to service the event by the IOM issuing a 


Send Count instruction to the send/receive counter in 
the QCT. 





Programming Notes: 


1. 


The QCT event stack must be aligned on a word 
address boundary and located in the same virtual = 
real resident segment as the QCT. 


. One QCT event stack must be allocated for each 


QCT. 


. The maximum size of the QCT event stack associated 


with the particular QCT is determined by the number 
of event fields that may be posted in the stack from 
the device or event handler. A minimum size of four 
is specified (event limit = hex 0004). 


. The maximum number of entries allocated for the 


QCT event stack is determined by the number of 
function events that may be posted to the OU task. 
The minimum number of entries allocated must be 
greater than or equal to four. If the stack is full 
(event count is equal to the event limit field) when 
the event handler attempts to place an event on the 
stack, the event handler sets the lock bit in the QCT, 
changes the event field to an error event, and posts 
the event field to the QCT event stack of the channel 
operational unit. 


ADDRESS LIST ELEMENT 


The ALE (address list element) is an 8 byte object 
containing a virtual or virtual = real address to be used 
during page chaining operations. The ALE is a single 
element in a page chain address stack used during the 
processing of a function operation block command. 


The first ALE data address field is loaded into the data 
register specified in the QCT (queue control table) and 
the address of the ALE is placed in the QCT in the ALE 
pointer field. If the end of multiple load bit in the ALE 
control field is not set, the next ALE is processed. This 
next ALE data address field is loaded into the data 
register calculated by adding 1 to the value of the 
previous data register number. The address of the ALE 
is then placed in the QCT-ALE pointer-field in the QCT. 
ALEs are continually processed until the end of multiple 
load bit is encountered. A maximum of 14 1/O data 
registers may be loaded in this manner. 
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Format: 2 
) 





TyPe | Control Data Address 
C3 
0 1 2 Bytes 8 
Bytes. Bits Description Programming Notes: 
1. The address list element must be aligned on a 
0 Type: ALE type code (hex C3). doubleword address boundary. 
2. The address list element stack must be located in a 
1 Control: Control field. virtual = real segment. The virtual = real address of 
the first ALE in the stack is in bytes 2-7 of the 
0 End Of List: function operation block using page chaining. 
3. The location pointed to by the ALE data address 
Q Not the last member of an ALE must be aligned on a doubleword boundary. 
stack. 


1 The last member of an ALE stack. 
1 End Of Multiple Load: 


The I/O resolved address registers ‘ 
starting with the primary data register 2 
specified in the OCT, are ioaded with 

resolved addresses contained in the 

ALE list up to and including the ALE 

having the end of multiple load bit set. 

A maximum of 14 contiguous |/O 

resolved address registers can be 

loaded. 


2-/ Reserved: Must be zeros. 
2-/ Data Address: A virtual or virtual = 


real address to be used during page 
chaining. 
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I/O Storage Addressing 


I/O RESOLVED ADDRESS REGISTERS 


The |/O resolved address registers are hardware 
registers in the processor that contain resolved virtual 
addresses and are used by an |/O device to access 
command information, post command completion status, 
and to transfer device data to or from real storage. 


The !/O resolved address register assignments (made at 
system specialization time) are passed to devices at 
initialization time, for example, when an active session is 
first established. 


The number of |/O resolved address registers assigned 
to a particular device is variable up to a maximum of 15. 
A single device requires a command register to address 
the command/response field of the function operation 
block and one or more data registers for the transfer of 
device data. 


The |/O resolved address register, used during a 
channel operation, is selected by the device. 
Addressability of a maximum of 256address registers is 
provided by all models of the 5381 System Unit. 
Addressability of a maximum of 384 address registers is 
provided by all models of the 5382 System Unit. 


Whenever a newly resolved virtual address is loaded 
into an |/O resolved address register, the use count in 
the primary directory entry (see Chapter 8) for that 
address is incremented. When the |/O resolved address 
register is invalidated, the use count is decremented. 


Notes: 

1. Unless loaded by FOB (function operation block) or 
an AOB (address operation block), an |/O resolved 
address register contains an address that may have 
been modified by the last instruction of an FOB. The 
modification is device dependent. 

2. For those devices using multiple contiguous I/O data 
address registers, only the first (primary) data address 
register is uniquely specified in the queue control 
table for that OU (operational unit) task. 


PAGE CHAINING 


The page chaining facility of the |/O structure transfers 
device data, during the execution of a single function 
operation block, to several noncontiguous pages. The 
operation is referred to as page chaining, since the 
address used by the device during the storage transfers 
is changed only on page boundaries. 


Page chaining is invoked during the OU task processing 
of an FOB. The set data address and page chaining 
control bits of the FOB must be set prior to the initiation 
of the OU task. When both bits are a 1, the address in 
the data address field of the FOB is a V=R address of 
the first ALE (address list element) of a page chain 
stack. This address is placed into the QCT (queue 
control table) for use by the event handler. (See the 
following diagram.) 


The event handler accesses the QCT (queue control 
table) of the device to determine if page chaining is 
being used. The QCT contains the page chaining control 
bit set by the OU task and the ALE pointer field, which 
is updated (from the data address field of the FOB) 
during each boundary crossing, to point to the next ALE 
in the page chain stack. 


The first ALE of the page chain stack is accessed by the 
OU task and the address in the ALE is resolved and 
loaded into the data address register of the device. 
Following resolution of the address in the ALE, which 
may be either virtual or V=R, a start device command is 
issued to the channel hardware. 


A page boundary crossing is always indicated by the 
VAT (virtual address translator) hardware if page 
chaining is used and the address contained in the 
register is modified across a page boundary. 


The page boundary crossing is serviced by the event 
handler. The new address to be resolved is obtained 
from the next ALE in the page chain stack instead of 
using the address in the |/O resolved address register. 


Notes: 

1. The page chain must be in a V=R segment. 

2. The data addresses contained in the address list 
element can be either virtual or V=R. 

3. Page chaining still occurs at a page boundary even 
though the address in the ALE is V=R. 
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Page Chain Stacking 


OCT 


Type (D8) 
11011000 


Command Data 
Register 


Control! 


I/O Resolved Address Registers 


PAGE FAULTS 


Page faults can occur during the modification of 
resolved virtual addresses in |/O resolved address 
registers during channel operations or during the 
resolution of virtual addresses contained in operation 
blocks. 


If a resolved virtual address in an |/O resolved address 
register is incremented or decremented across a page 
boundary during channel operation, the |/O event 
handler attempts to resolve the address by reference to 
the primary directory. If the virtual address is not in the 
primary directory, the |/O event handler performs a 
send count to make the OU task dispatchable to resolve 
the page fault using the IMP exception mechanism. 


A page fault occurring during the execution of an 
operation block by an OU task is also resolved through 
the IMP exception mechanism (address translation 
exception). 


Register 





FOB J 


Type (C6) | Control Data 
11000110 | xxxx11xx Address 


} 


Page Chain Stack 








Data Address 








VIRTUAL = REAL 


The IMP virtual address mechanism is used by I/O 
devices operating on the channel. Virtual addresses 
containing virtual = real SIDs (segment identifiers) can 
be used as |/O addresses in operation blocks. 


Note: Page crossing and page chaining are handled by 
the event handler without need for a task switch. 


I/O ADDRESSING RESTRICTIONS 


Addresses of |/O objects have boundary and alignment 


restrictions (see the following table). 
I/O Object Address Restrictions 


Address 
I/O Object’ Address Type Cross ee Boundary 


a — |__| 
1/0 Event Stack [Work vee | 
[1/0 Register Table [Mattword VR | NO 
i/o event Stack [Work vee | NT 


'No object may cross an SID (segment identifier) boundary. 
The first 32 bytes may not cross a page boundary. 

3Must be in the same V=R segment as the I/O register table. 
‘Must start and end on a page boundary, and the page must be pinned V=V. 







| 
@ 
77) 
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I/O Events 


An |/O event is a unit of work requested by the 
channel, device, or |OM (I/O manager) task of an OU 
(operational unit) task or the |/O event handler. This 
unit of work is described by 4 bytes called an |/O event 
field. The |/O event can be one of three types: 
function, address, or error. 


I/O EVENT FIELDS 


The general formats of the |/O event field for the three 
event types are: 


Function Event 


Event-Dependent 





0 1 Bytes 4 


Legend: f= 4-bit function type code 


Address Event 


1/0 


Register 
Number 





0 1 2 Bytes 4 


Legend: e = event-dependent 


Error Event 


elee eeee eeee eeee 
eeee eeee eeee eeee 
0 1 2 


Bytes 4 





Legend: e = event-dependent 


Function Event : 
| > 


The function event communicates device or |OM work 
requests to an OU task. The function event normally 
requested by an I/O device is the command completion 
indication (command end or command end/fetch next 
command). The function event used by the IOM task 
(fetch next command) is normally used to restart an OU 
task following an error situation. 


Command End/Fetch Next Command 


The command end/fetch next command function is 
requested by an |/O device at the completion of an FOB 
(function operation block) command. The function event, 
when requested by an |/O device, signifies that the 
current FOB has been successfully completed and the 
OU (operational unit) task can proceed to process 
operation blocks in the current ORE (operation request 
element) if they are available. If the operation blocks in 
the current ORE have been processed, then the OU task 
places the ORE on the IOMQ (!/O manager queue), the 
response queue, and requests (for example, receives) a 
new ORE from the OU queue. 


The command end/fetch next command function event ’ | 
contains the BSTAT (basic status) information provided 


by the |/O device. The BSTAT information is placed 
into the OU status field of the ORE by the OU task. 


Format: 


Basic Status 


0 1 2 Bytes 4 


Command End 


The command end function event is used by an |/O 
device to communicate error or exception status to the 
device IOM task. The function request indicates that the 
device cannot proceed to execute commands until 
recovery operations are performed. 


The command end event field contains the 2-byte 
BSTAT information provided by the device. The BSTAT 


information is placed into the OU status field in the 
current ORE before the ORE is enqueued on the IOMQ. 


Format: 


Basic Status 


Hex 02 | IOREG 





Fetch Next Command 


The fetch next command function is normally used by 
an IOM task to restart the OU task following an error 
situation. The IOM task forms the event field, places 
the 4-byte field into the QCT (queue control table) event 
stack, and issues a Send Count instruction to the SRC 
(send/receive counter) in the QCT to cause the OU task 
to be dispatchable. 


The fetch next command function causes the OU task to 
issue a Receive Message instruction to the OU queue to 
obtain a new ORE. 


Format: 
enn) xe 
0 1 2 Bytes 4 


Address Event 


The address event indicates that a page boundary 
crossing occurred during the modification of a resolved 
virtual address contained in an |/O resolved address 
register. If address chaining is not being used by the 
device, the virtual address to be.resolved is contained in 
the |/O resolved address register indicated by byte 1 of 
the field. 


If address chaining is being used, the next virtual 
address from the address list will be resolved. 


Format: Address events are not seen by the IMP 
channel interface; however, for completeness, the 
format of the address event is shown below: 


1/0 


Register 
Number 





0 1 2 Bytes 4 


Legend: d = device-dependent 


Error Event 


The error event communicates error and/or exception 
conditions involving the channel hardware, interface, and 
specific conditions of devices to an IMP (IOM) channel 
error task. The channel 1OM task performs logging and 
recovery operations and communicates with the OU 
tasks of the channel. Refer to Channel Error Recovery in 
this chapter for details. 

Format: 


elee eeee eeee eeee 
eeee eeee eeee eeee 
e) 1 


2 Bytes 4 





Legend: e = event-dependent 


The other function events are described in the Channel 
Theory-Maintenance manual. 
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I/O EVENT HANDLER 


The |/O event handler (Figure 7-4) is a horizontal 
microcode function that is invoked by the channel 
hardware to post an I/O channel event request to the 
processor. The horizontal microcode services the |/O 
events represented by the |/O event fields in the event 
stack. 


Depending on the event field type, the event operation 
can be completely performed by the |/O event handler 
or the |/O event handler can send to an OU task to 
service the request. The I/O event handler relinquishes 
control when all entries in the event stack are removed 
and serviced. 




































1/O Event Field 
Formation 
IOM Function Event 
1OM Forms ) OU 
Task 
Update 
I/O RAR? 
Device Function Event Address 
Channel Forms r a a a a a a a a a a rn nn nr nr nnn rn te 7 
Function 
3 3 
Channel Address Event Address 
Channel Forms H 
Form ! 
| Select | Allocate Page, Function ! 
Channel Error Event ! and Resolve Next Event ! 
Channel Forms 1 Route | Page Page 1 
Referenced 
in PD : 
! Error Yes ! 
1 I 
r Away I 
1 I 
I r 
11/0 Event Handler |____ = YNo 
Update 
Pe Channel 






OU 
Task 


1 Brimary directory 
Resolved address register 


Figure 7-4. Event Handler Overview 
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I/O EVENT STACK 


The I/O event stack is a list of contiguous 4-byte 
elements. The elements are |/O event fields that are 
placed on the stack by the channel hardware. The stack 
address used by the channel when placing an entry on 
the stack is in the event stack |/O resolved address 
register (hex OO). 


The |/O event fields are removed from the event stack 
by the |/O event handler. The event stack |/O resolved 
address register is also used by the |/O resolved event 
handler when removing entries from the stack. In 
removing entries from the stack, priority is given to the 
address event class. Outside of this prioritization, events 
are removed on a last in, first out basis. 


Programming Note: The event stack must start and end 
on a page boundary, must be pinned and V=V storage, 
and the page must be resident. This limits the stack to 
128 entries. If the event stack overflows, a machine 
check will occur. 


I/O REGISTER TABLE 


The I/O resolved register table provides addressability 
to the various queue control tables in the machine. The 
table is used by the I/O event handler to locate the QCT 
(queue control table) of the device. The QCT must be 
located to place an I/O event field in the QCT event 
stack and to dispatch the OU (operational unit) task. 
Dispatching the OU task is done by issuing a Send 
Count instruction to the SRC (send receive counter) in 
the QCT. 


The I/O register table contains a halfword (2-byte) entry 
for each |/O resolved address register. Each halfword 
entry contains an address offset into the segment to 
locate a QCT. Each device must have a OCT assigned. 
If a device uses multiple |/O resolved address registers, 
there are likewise multiple entries in the |/O register 
table. All of the multiple entries for a device contain the 
same offset, pointing to the same QCT. For example, if 
an 1/O device is assigned a command register number 
of hex 10 (decimal 16) and a data register number of 
hex 11 (decimal 17), then halfword locations 16 and 17 
of the |/O register table would contain the same offset 
so they would both point to the same QCT. 


Programming Notes: 

1. The |/O register table is aligned on a halfword 
address boundary and must be in the same V=R 
segment as all queue control tables. The address of 
the |/O register table is in the control address table 
(described in Chapter 2). 

2. If an |/O resolved address register is not assigned to 
a device, then the corresponding entry in the table 
must contain hex FFFF. The event handler will then 
change the event to an error event and post it to the 
channel IOM. 

3. The |/O register table must not cross a segment 
boundary. 

4. |/O resolved address register 2 (hex 02) contains the 
address of the channel OU task QCT. 
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|/O Command Responses 


INPUT/OUTPUT STATUS FIELDS 

The types of |/O status information defined are: 
¢ BSTAT (basic status) 

e FSTAT (functional status) 

- DSTAT (device status) 


The read sense command (issued to the operational unit 
task) returns at least 2 bytes of DSTAT. Either 
additional read sense commands, or additional (more 
than: two) DSTAT bytes, or both, can be defined to 
allow program access to all or additional DSTAT 
information. 


The status information is contained in the description for 
each adapter or device. Only a general description is 
given here because the information is device dependent. 


Basic Status 


The BSTAT (basic status) consists of 2 bytes of adapter 
response data. The adapter response is provided to the 
channel along with the command end or command 
end/fetch next command indication. Status is stored in 
the |/O event stack by channel hardware and is moved 
to the OU (operational unit) status field of the ORE 
(operation request element) (operational unit) by the OU 
task (see Figure 7-7). Only the first byte of BSTAT is 
required; the second byte is optional. 


Bit 


0-1 


2 


BSTAT bytes are as follows: 
> 


Description 
Reserved for the channel. 
Halt: 


O No device halt condition 
detected by the channel. 


1 Device halt condition detected 
by the channel. 


Channel Error: 


QO No error detected during 
channel transfers. 


1 Error detected during channel 
transfers. 


1/O Exception: 


O No device exception condition 
detected. 


1 Device exception condition J 
detected. 


Note: |/O exceptions can be 
suppressed. An exception is 
suppressed when the condition 
that causes the exception does 
not inhibit setting the command 
complete bit (bit 7). A 
suppressed condition sets the 
|/O exception bit on. 
Suppression is a device option 
and may or may not be 
programmable. Examples of |/O 
exceptions that might be 
suppressed are last card on card 
units and incorrect length on tape 
units. 


Bytes 


(Hex) Bits Description 


Command Reject: 


O Command was acceptable for 
execution. 


1 Operational unit is not 
designed for, or is in a state 
that prevents, command 
execution. 


6 1/O Error: 


O No error detected by the 
operational unit during 
execution of a function 
operation biock. 


1 Error detected by the 
operational unit during 
execution of a function 
operation block. A read sense 
command must be issued to 
receive the device status bytes 
to determine the error 
condition. 


7 Command Complete: 


QO Command specified by an 
operation block has not begun, 
or not successfully completed 
execution. 


1 Command specified by an 
operational block has 
successfully completed 
execution. 


1 Optional and need not be supplied 
by the operational unit. This byte is 
set to zeros by the channel if not 
supplied by the operational unit. 


Functional Status 


The FSTAT (functional status) consists of from 1 to 4 
bytes of operational unit information that can be 
required by the program for normal device operation, 
such as returning a record length from a tape unit. 


The FSTAT is transferred into the response portion of 
the command response field (see Figure 7-7) of the 
FOB (function operation block) using the OU (operational 
unit) |/O command register. 


The FSTAT is device-dependent and may be 
command-dependent. The FSTAT is also optional. 


If the IOM (I/O manager) needs to interrogate FSTAT 
before the next operation block is executed, |/O 
exception must be set and command end must be 
indicated to the channel by the operational unit. 


Device Status 


The DSTAT (device status) consists of any number of 
bytes defined by a device for its status. 


The DSTAT is transferred to the data field of the Read 
Sense command, using the operational unit primary data 
register. The bytes contain information required for 
proper device maintenance. 


The DSTAT bytes common to all devices are defined as 
follows: 


Byte Description 


€ Same as BSTAT byte O of previous FOB 
(function operation block) command executed 
by the adapter. 


1 If BSTAT byte 1 is used by the operational 
unit, DSTAT byte 1 is the same as the 
BSTAT byte for the previous FOB. If BSTAT 
byte 1 is not used by the operational unit, 
DSTAT byte 1 is device dependent. 


All remaining DSTAT bytes are device~dependent and 
optional. 
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Intervention-Required Signal 


The !/O units that require operator intervention include 
one or more commands that indicate when the condition 
is cleared. Intervention-required conditions include: 


e Printers 
— End of form 
— Forms jam 


« Card Machines 
— Stacker full 
— Hopper empty 


¢« Tape Units 
— Tape not mounted 


An intervention-required condition is cleared when the 
operational unit can execute functional commands, such 
as, print, read card, read block, and so forth. The I/O 
error or !/O exception status is returned for all such 
functional commands when an intervention-required 
condition is present. 


To test if the intervention-required condition has ended, 
a special command type is used. For example, a printer 
could use a return-ready command. This command 
notifies the program when an intervention-required 
condition, such as end of form, is cleared and the 
printer made ready. The I/O unit (printer and 
attachment) does not complete the command until the 
intervention-required (new forms loaded) condition is 
cleared and the printer made ready (by pressing the start 
key). 


Device conditions other than intervention-required allow 
immediate execution of the return ready with I/O 
exception or |/O error status bits set. All printer 
commands other than return-ready immediately execute 
with the |/O exception or I/O error status bit set. 


FUNCTION OPERATION BLOCK TIME-OUT 


The FOB (function operation block) time-out capability ao 
of the system provides a mechanism for testing active 

|/O operations to determine if a channel end or device 

end interrupt has been outstanding for more than the 

period of time specified at system specialization. 


The FOB time-out mechanism is implemented in the 
channel IOM (!/O manager) routines for all |/O devices 
except disks which have an implementation-dependent 
time-out mechanism. Fields included in each device 
QCT (queue control table) to maintain the information 
for FOB timing are: 


Field Description 

Control Byte 1, bit 2- FOB in progress 

FOB Timer Bytes hex 20 and 21-time 

Count elapsed for current FOB in 
n-second increments 

FOB Timer Bytes hex 22 and 23- 


Limit timing limit for FOB in 
in n-second increments 


Operation . 


The following sequence describes the operation of the 
FOB time-out mechanism: 


1. | The device |OM program loads a value appropriate 
for the FOB to be executed into the QCT prior to 
sending the ORE (operation request element) to 
the OU (operational unit) task. The limit byte in 
the QCT provides a range of FOB time-out values 
with 1 to 255 timing intervals. 


2, The OU task processes the ORE received from the 
IOM, loads the appropriate command and data 
registers, sets the FOB-in-progress bit in the 
QCT, and initiates the start-device sequence to the 
channel hardware. 


3. The channel |OM, concurrent with the processes 
described above, tests all device QCTs, on 
n-second intervals for an active FOB-in-progress 
bit. The actions taken by the channel |OM when it 
detects an FOB-in-progress are shown below. 


FOB-In- FOB Timing- 
Progress In-Progress Channel IOM Action 
1 0 Resets count byte; sets 


FOB timing-in-progress bit 
1. Increment count byte. 


2. If count byte = 
limit byte, then 
send time-out 
MSG to device 
IOM; else EXIT. 


4. The device OU task resets the FOB-in-progress 
and the FOB timing-in-progress bits in the QCT 
when the device posts a CE (command end) or a 
CE/FNC (fetch next command). 


1/O EXAMPLE 


Figure 7-5 (parts 1 through 14) depicts the sequence of 
events in an |/O operation under the assumption that 
the OB (operational block) contained in the ORE 
(operation request element) is an FOB (function 
operation block). 


Figure 7-6 (parts 1 through 13) depicts the sequence of 
events in an |/O operation which is similar to that of 
Figure 7-5, but which makes use of the SENDMW 
instruction. 


Note: The dotted arrows represent an action of the 
processor and the solid arrows represent a pointer. 
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With no I/O operations taking place, the IOM (I/O 
manager) task [ff is on the RDQ (task dispatching 


queue) ready to run and the OU task [BM is in the wait 


list of the OUQ (operational unit queue). 


The QCT (queue control table) for this OU task was 
initialized at IPL (initial program load) time with the 


entries shown. 


When the IOM task becomes the top priority task on 


the TDQ, the I/O operation starts. 


1/O Manager Queue 


First TDE First Message 
Address Address 


Task Dispatch Queue 









Queue Control Table 


Command Register Number 
Data Register Number 


QCT Event Stack Offset 





Figure 7-5 (Part 1 of 14). Sequence of I/O Operations 
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Operational Unit Queue 


First TDE 
Q 
mop 


EN 1OM Task OU Task 


First Message 
Address 





Ey) The IOM task issues a Send Message instruction 
to the OUQ. 


Es The Send Message instruction puts an ORE on the 
message list. 


1/O Manager Queue 


First TDE First Message 
Address Address 
1OM Task 


Task Dispatch Queue Operational Unit Queue 


First TDE 






First Message 
Address 


i 


/ 


/ 
y 
EB] oe | cumini: | 






Queue Control Table 


Command Register Number 
Data Register Number 


QCT Event Stack Offset 
SRC 





Figure 7-5 (Part 2 of 14). Sequence of I/O Operations 
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Because the OU task is on the wait list of the 
QUQ, the Send Message instruction puts the OU 
task on the task dispatch queue in priority 
sequence. When the OU task is dispatched, the 
OU task base registers are loaded with task 
control information resident in the OU TDE. 


|/O Manager Queue Task Dispatch Queue 


First TDE First Message 
Address Address 


TDE 10M Task 


OU Task Base Registers 


{OMO Address 
OUO Address 


QCT Address 





Figure 7-5 (Part 3 of 14). Sequence of !/O Operations 







Operational Unit Queue 


First Message 
Address 


Queue Control Table 


Command Register Number 
Data Register Number 
















QCT Event Stack Offset 


SRC 





The OU task issues a Receive Message instruction [J 
dequeuing the ORE from the OUQ §J. 


The OUQ address, IOMO address, and the QCT address 


are contained in the base register space [EJ of the OU 
task. 


[Es The addresses of the executing ORE and the 
current OB (operation block) are stored in OU task 


base registers. 


ff} The OU task locates the QCT via an OU task base 
register entry. 


I/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message First TDE First Message 






a [loom 





OU Task Base Registers 


Queue Control Table 










Command Register Number 
Data Register Number 
QCT Event Stack Offset 


Current ORE Address 


Current OB Address 






OUOQ Address 







QCT Address 





Figure 7-5 (Part 4 of 14). Sequence of I/O Operations 
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locate and load an I/O RAR (resolved address register) 
12 with the resolved address of the command/response 
field (byte hex 18 of the ORE). 


The OU task uses the command register number 11 to ) | 


[FE sif required, an I/O RAR is located by the data 
register number and loaded with the address in 
bytes 2-7 of the operation block. 


FZ) The OU task requests a start device sequence of 
the channel hardware. The device can now 
transfer additional command and data information 
without direct CPU involvement. 


ff sThe OU task issues a Receive Count instruction to 
the SRC (send receive counter) in the QCT. The 
SRC js initialized with a count of zero and a limit 
of one. 


|/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message 0UO First TDE First Message 
Address Address Address Address 
14 OU Number 





TDE 1OM Task 









OU Task Base Registers 
1OMQ Address 
Current ORE Address 
Current OB Address 
OUOQ Address 


QCT Address 





Queue Control Table 


Command Register Number 
Data Register Number 13 
OQCT Event Stack Offset 

























1/O Registers (RAR) 


Command Address 













Data Address EF} 





Figure 7-5 (Part 5 of 14). Sequence of I/O Operations 
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16 Because the SRC count is zero and less than the 
limit of one, the OU TDE is chained to the SRC, 
waiting for a command completion request from 
the 1/O device. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message 
—— 
| ! aha because 


sk 
peas) 


TDE 1OM Task 









OU Task Base Registers 


Queue Control Table 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 
src [fy 















1IOMOQ Address 


Current ORE Address 


- 


1/O Registers (RAR) 


Command Address 


Current OB Address 





OUO Address 


QCT Address 


Data Address 


Figure 7-5 (Part 6 of 14). Sequence of I/O Operations 
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Control passes (task switch) to the task with the 
highest TDE priority. In this example, [OM task 
has priority so it resumes execution at the point 
following the Send Message instruction of the 
ORE to the OUQ. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message First TDE 
TDa 
co Address) ) Address et ee 





First Message 
Address 





Queue Control Table 















Command Register Number 
Data Register Number 
QCT Event Stack Offset 






TDE OU Task 


1/0 Registers (RAR) 


Command Address 
Data Address 










Figure 7-5 (Part 7 of 14). Sequence of I/O Operations 
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ff) 9 When the IOM task TDE reaches a point where it 
has to wait for the completion of the I/O 
command, the |OM task TDE issues a Receive 
Message instruction to the IOM queue. 


19 Because there are no messages on the |IOMQ 
message (msg list), the IOM task TDE is queued 
to the [OMQ wait list. 

FX] Control passes to the task with the highest 
priority. In this example, task B would begin 


execution. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message First TDE First Message 
TDE 1OM Task | one OU Number 









Queue Control Table 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 













OU Task 


1/O Registers (RAR) 


Command Address 


Data Address 


Figure 7-5 (Part 8 of 14). Sequence of I/O Operations 
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supplies command completion information to the 
channel. The channel uses this information to form 
a 4-byte I/O event field (function event type in 
this case) and place this field on the |/O event 
stack (see Figure 7-7). Channel hardware now 
signals an |/O channel event to the processor. 


21 Upon completing the command, the device 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE | First Message oua First TDE First Message 
Address Address Address Address 
TDE IOM Task | one OU Number 





Queue Control Table 








Command Register Number 


Data Register Number 


QCT Event Stack Offset 
I/O Event Stack 


1/O Event Field 










TDE OU Task 


Figure 7-5 (Part 9 of 14). Sequence of !|/O Operations 
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A channel HMC (horizontal microcode) routine, called 24 
the |/O event handler, executes when the processor 

accepts the I/O channel event. The event handler does 

not execute as a task (no task switch occurs). 


The present task is temporarily suspended. 


FE] The I/O event handler accesses an event field in 26 
the |/O event stack. 


1/O Manager Queue 


First TDE First Message 
Address Address 
ee 


Task Dispatch Queue 











\/O Reg Table 







octotieer Eg 





TDE OU Task 


Figure 7-5 (Part 10 of 14). Sequence of I/O Operations 





Queue Control Table 


Command Register Number 


Data Register Number 
Event Count 
QCT Event Stack Offset 


eee 


The event handler accesses an |/O register table 
entry using the |/O register number in the |/O 
event field as an offset into the table. 


The |/O register table entry (QCT offset) is used 
to locate an offset pointer in the OU QCT. 


The QCT entry (QCT event stack offset) is used to 
locate an entry point in the OU QCT event stack. 


The event handler moves the event field from the 
|/O event stack (see Figure 7-7) to the QCT event 
stack and increments the event count in the QCT. 


Operational Unit Queue 


First TDE First Message 
OUQ Address Address 
| one | OU Number 


| Event Stack 


1/O Event Stack 


1/0 Event Field 





5 










is 
9 





rc 
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1/0 and Asynchronous Events 


A Send Count instruction is issued by the event ' 
handler to the QCT SRC header. The Send Count J 
instruction increments the SRC count. 


The TDE of the OU Task is placed on the TDO in 
priority sequence. 


The event handler repeats the sequence (in this 
example, numbered 23-29) until all entries are removed 
from the I/O event stack. 


|/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message UO First TDE First Message j 
Address Address O Address Address 

| 

| | one | OU Number 


TDE IOM Task 








Queue Control Table 
Command Register Number 
Data Register Number 

QCT Event Stack Offset 


QCT Offset 








QCT Event Stack 


1/O Event Field 


1/O Event Stack 












- 
| 
| 
| 
| 
| 
| 

1/O Reg Table 

/ g Tabl , 2 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 





C | 
| | 
| TDE OU Task 1/O Event Field 
| | 
Lo coh as ae eee 


Figure 7-5 (Part 11 of 14). Sequence of I/O Operations 
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Ff] Control Passes to the TDE with the highest The OU task locates the I/O event field and 


priority. In this example, the OU task begins checks the channel command byte of the event 
execution. field for the function event type. 

The OU task issues a Receive Count instruction to When the function event type is a command 
the QCT SRC. This implicitly tests for waiting completion indication, that is, tf command end or 
events in the QCT event stack. command end/fetch next command is the function 


type, then the BSTAT field of the |/O event is 
moved to the OU status field of the ORE. (See 
Figure 7-7.) 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message 
30 } one | oustatus 





OU Task Base Registers 












QCT Event Stack 


a 
ee 












Data Register Number 


QCT Event Stack Offset 






| 
| 
| 
{ 
| 
| 
| 
| 
‘| 





Figure 7-5 (Part 12 of 14). Sequence of |/O Operations 
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1/O Manager Queue 





OU Task Base Registers 





a 
emeonene 
ee 
ae 


If command end is the command completion 
indication, the OU task issues a Send Message 
instruction to the |OMQ, placing the ORE on the 
IOMQ. 


The OU task then issues a Receive Count 
instruction to the OCT SRC. The OU task now 
resides on the QCT SRC wait list, waiting for an 
IOM work request to be placed on the QCT event 
stack. 











Figure 7-5 (Part 13 of 14). Sequence of |/O Operations 
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Task Dispatch Queue 








If (instead of EZ] and —) command end/fetch next 
command is the command completion indication, 
the OU task checks the current OB (operation 
block) for the last OB in ORE. When the current 
OB is not the last OB, the task processes the next 
OB. If the current OB is the last OB, the task 
issues a Send Message instruction to |OMQ, 
placing the current ORE on the IOMQ message 
list. 


Operational Unit Queue 


First TDE First Message 


Queue Control Table 


Command Register Number 
Data Register Number 


QCT Event Stack Offset 


SRC 


|/O Manager Queue 


First TDE 
Address 


Because the TDE of the IOM task is on the |OMQ 
wait list, the Send Message instruction to the 
IOMQ places the IOM task on the TDQ in priority 
sequence. 


The OU task now issues a Receive Message 
instruction to the OUQ. With no messages (OREs) 
queued to the OUQ message list, the OU task is 
dequeued from the TDO and placed on the OUQ 
wait list. 


The |OM task resumes execution (task switch) if it 
is of higher priority than task B. 


First Message 
Address 






Figure 7-5 (Part 14 of 14). Sequence of I/O Operations 


Task Dispatch Queue 


First TDE 
mop | 


Operational Unit Queue 


First Message 
Address 
OU Task 
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With no |/O operations taking place, the IOM (I/O 
manager) task ei is on the TDQ (task dispatch queue) 2 
ready to run, and the OU task is on the wait list of 

the OUQ (operational unit queue). 


The QCT (queue control table) for this OU task was 
initialized at IPL (initial program load) time with the 
entries shown. 

When the IOM task becomes the top priority task on 
the TDQ, the |/O operation starts. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message TDo oua First TDE First Message 
Address Address Address Address 
1 | IOM Task OU Task 















Queue Control Table JZ 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 









Figure 7-6 (Part 1 of 13). Sequence of I/O Operations with SENDMW Instruction 
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The IOM task issues a Send Message and Wait 
instruction to the OUQ. 


The Send Message and Wait instruction puts an 
ORE on the message list of the OUQ and 
removes the current TDE from the TDQ. 


I/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message First TDE First Message 


a cee 
b TDE 
OU Number Aaddises 
eae eet ee ee 









Queue Control Table 


Command Register Number 


Data Register Number 
Event Count 


QCT Event Stack Offset 
SRC 





Figure 7-6 (Part 2 of 13). Sequence of I/O Operations with SENDMW Instruction 
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Because the OU task is on the wait list of the 
QUQ, the Send Message and Wait instruction 
puts the OU task on the task dispatch queue in 


priority sequence. When the OU task is 
dispatched, the OU task base registers are 


loaded with task control information resident in 


the OU TDE. 


I/O Manager Queue Task Dispatch Queue 


First TDE First Message 
Address Address 


OU Task Base Registers 


!1OMQ Address 


OUO Address 
QCT Address 





Figure 7-6 (Part 3 of 13). Sequence of I/O Operations with SENDMW Instruction 
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Operational Unit Queue 







Queue Control Table 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 










The OU task issues a Receive Message instruction 6 
dequeing the ORE from the OUQ EZ. 


The OUQ address, IOMQ address, and the OCT address 
are contained in the base register space 8 | of the OU 
task. 


9 | The addresses of the executing ORE and the 
current OB (operation block) are stored in the 
OU task base registers. 


The OU task locates the QCT via an OU task 
base register entry. 


I/O Manager Queue Task Dispatch Queue 


First TDE First Message 
Address Address 


OU Task Base Registers 


}OMQ Address 


Current ORE Address 














Current OB Address 


OUQ Address 
QCT Address 





Figure 7-6 (Part 4 of 13). Sequence of |/O Operations with SENDMW Instruction 





Operational Unit Queue 


First TDE First Message 
G 
TDE 
Address 






Command Register Number 
Data Register Number 


QCT Event Stack Offset 
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The OU task uses the command register number 11 to 
locate and load an |/O RAR (resolved address register) 
with the resolved address of the command/response 
field (byte hex 18 of the ORE). 


If required an |/O RAR is located by the data 
register number and loaded with the address in 
bytes 2-7 of the operation block. 


14 The OU task requests a start device sequence 
of the channel hardware. The device can now 
transfer additional command and data 
information without direct CPU involvement. 


The OU task issues a Receive Count instruction 
to the SRC (send receive counter) in the QCT. 
The SRC is initialized with a count of zero and a 
limit of one. 


1/O Manager Queue Task Dispatch Queue 


First TDE. First Message 
Address Address 


OU Task Base Registers 





| 1OMQ Address 


Current OB Address 
pennants 
Le 











1/O Registers (RAR) 


Command Address 12 





Data Address 13 


Figure 7-6 (Part 5 of 13). Sequence of I/O operations with SENDMW Instruction 
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Operational Unit Queue 


ouO First TDE First Message 
Address Address 





Queue Control Table 


Command Register Number [i] 
Data Register Number 13 


QCT Event Stack Offset 





Because the SRC count is zero and less than 
the limit of one, the OU TDE is chained to the 
SRC, waiting for a command completion 
request from the I/O device. 


|/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message oua First TDE First Message 
Address Address Address Address 


TDE 
Address 
1OM Task 


Queue Control Table 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 
src [G 
















OU Task Base Registers 


1OMQ Address 











Current ORE Address 






- 


Current OB Address 


1/O Registers (RAR) 


Command Address 
Data Address 


Figure 7-6 (Part 6 of 13). Sequence of I/O Operations with SENDMW Instruction 





OUQ Address 






QCT Address 
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the highest TDE priority. In this example, task 


Control passes (task switch) to the task with 
> 
B would begin execution. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message TbDa oua First TDE First Message 
Address Address Address Address 


TDE 
17 
TDE 1IOM Task 















Queue Control Table 


Command Register Number 
Data Register Number 
QCT Event Stack Offset 








1/O Registers (RAR) 


Command Address 
Data Address 


Figure 7-6 (Part 7 of 13). Sequence of I1/O Operations with SENDMW Instruction 
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18 Upon completing the command, the device 
supplies command completion information to 
the channel. The channel uses this information 
to form a 4-byte |/O event field (function event 
type in this case) and places this field on the 
|/O event stack (see Figure 7-7). Channel 
hardware now signals an |/O channel event to 
the processor. 


|/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE First Message ova First TDE First Message 
Address Address Address Address 
- TDE 
OU Number Address 





Queue Control Table 








Command Register Number 
Data Register Number 
QCT Event Stack Offset 










1/O Event Stack 


1/O Event Field 





Figure 7-6 (Part 8 of 13). Sequence of I/O Operations with SENDMW Instructions 
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A channel HMC (horizontal microcode) routine, called 
the |/O event handler, executes when the processor 
accepts the |/O event. The event handler does not 
execute as a task (no task switch occurs). 


The present task is temporarily suspended. 
The |/O event handler accesses an event field in 


the |/O event stack. 


1/O Manager Queue 


First TDE First Message 
Address Address 


1/O Reg Table 


— ee ee ee 







QCT Offset 2 2| 








OU Task 


Task Dispatch Queue 





Quere Control Table 


Command Register Number 
Data Register Number 


QCT Event: Stack Offset 


The event handler accesses an |/O register 
table entry using the |/O register number in the 
[/O event field as an offset into the table. 


The I/O register table entry (QCT offset) is 
used to locate an offset pointer in the OU QCT. 


The QCT entry (QCT event stack offset) is used 
to locate an entry point in the OU QCT event 
stack. 


The event handler moves the event field 

from the |/O event stack (see Figure 7-7) to 
the QCT event stack and increments the event 
count in the QCT. 


Operational Unit Queue 


First TDE First Message 
Address Address 








QCT Event Stack 


1/0 Event Field 


1/O Event Stack 


1/O Event Field 20 












wee * edie ee =a 









| 4 
Tg 
ES 





Figure 7-6 (Part 9 of 13). Sequence of |/O Operations with SENDMW Instruction 
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A Send Count instruction is issued by the event 
handler to the QCT SRC header. The Send 
Count instruction increments to the SRC count. 


The TDE of the OU Task is placed on the TDQ 
in priority sequence. 


The event handler repeats the sequence (in this 
example, numbered 20-26) until all entries are removed 
from the |/O event stack. 


1/O Manager Queue Task Dispatch Queue 


First TDE First Message 
Address Address 


---- 

| 
| 
| 
| 
| 
| 
1/O Register Table . 
ee 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 

geaenicemnaieng 

| 

Ph ee es 







| 
TDE 
| 


Queue Control Table 


Command Register Number 


Operational Unit Queue 


First TDE First Message 







QCT Event Stack 


1/O Event Stack 


1/O Event Field 















Figure 7-6 (Part 10 of 13). Sequence of I/O operations with SENDMW Instruction 
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Control passes to the TDE with the highest 
priority. In this example, the OU task begins 
execution. 

The OU task issues a Receive Count instruction 


to the QCT SRC. This implicitly tests for 
waiting events in the QCT event stack. 


1/O Manager Queue Task Dispatch Queue 


First TDE First Message 
Address Address 


OU Task Base Registers 


IOMQ Address 


Current ORE Address 


Current OB Address 


OUO Address Event Count 


QCT Address 


RO 
fee] 


SRC 







Queue Control Table 


Command Register Number 


Data Register Number 


QCT Event Stack Offset 


The OU task locates the I/O event field and ) 
checks the channel command byte of the event 
field for the function event type. 


When the function event type is a command 
completion indication, that is, if command end 
or command end/fetch next command is the 
function type, then the BSTAT field of the |/O 
event is moved to the OU status field of the 
ORE. (See Figure 7-7.) 


Operational Unit Queue 


First TDE First Message 
earns Address 
1OM Task 










QCT Event Stack 





I/O Event Fiela | 


SS 
Ei 


Figure 7-6 (Part 11 of 13). Sequence of I/O Operations with SENDMW Instruction 


~ 
' 


70 





If command end is the command completion 
indication, the OU task issues a Send Message 
instruction to the IOMQ. Since bit 6 of the 
description byte of the SRM is on, the message 
is not enqueued on the IOMQ. Instead, the 
IOM task TDE is enqueued to the TDQ. 


The OU task then issues a Receive Count 


If (instead of Ej and comand end/fetch 
next command is the command completion 
indication, the OU task checks the current OB 
(operation block) for the last OB in the ORE. 
When the current OB is not the last OB, the 
task processes the next OB. If the current OB 


is the last OB, the task issues a Send Message 


instruction to the QCT SRC. The OU task now 
resides on the QCT SRC wait list, waiting for an 
IOM work request to be placed on the ACT 


event stack. 


1/O Manager Queue 


First TDE First Message 
Address Address 


OU Task Base Registers 


1OMQ Address 
Current ORE Address 
Current OB Address 
OQUQ Address 


QCT Address 





Task Dispatch Queue 








Queue Control Table 


Command Register Number 
Data Register Number 


QCT Event Stack Offset 





instruction to IOMOQ as in above. 


Operational Unit Queue 


First TDE First Message 


Figure 7-6 (Part 12 of 13). Sequence of |/O Operations with SENDMW Instruction 
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The OU task now issues a Receive Message 
instruction to the OUQ. With no messages 
(OREs) queued to the OQUQ message list, the 
OU task is dequeued from the TDQ and placed 
on the OUQ wait list. 


The IOM task resumes execution (task switch) if 
it is of higher priority than task B. 


1/O Manager Queue Task Dispatch Queue Operational Unit Queue 


First TDE 
Address 


Figure 7-6 (Part 13 of 13). Sequence of |/O Operations with SENDMW Instruction 
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1/O Errors 


Extensive error checking is provided within the |/O 
structure to ensure correct operation of each component 
and to maintain the integrity of device data. |/O errors 
are OU (operation unit) errors when reported to the OU 
IOM (I/O manager) or channel errors when reported to 
the channel IOM. 


OPERATIONAL UNIT ERRORS 


Operational! unit errors, that is, operation program errors 
and device errors, report to the operational unit IOM via 
the 2-byte operational unit status field of the current 
ORE (operation request element). See Figure 7-7. 










OB 
Task Error Status ORE 
| ae | | emia 
Status 
E 10 Bytes 1A 20 





OR ——_———_—__—_____» OR 






1/O Event Stack 


1/O Event Field 


QCT Event Stack 


Basic Status 
(BSTAT) 





1/O Event Field 
0 Bytes 2 


Channel 
Hardware — X 







1/O Event Field 


0 Bytes 4 


Figure 7-7. Status Fields 
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Operation Program Errors 


Operation program errors occur during the execution of 
OBs (operation blocks) by the OU (operational unit) task. 
The type of operation program error is indicated in a 
2-byte field called the task error status field. 


Task Error Status Field 


The operation program error type contains an error code 
indicating the type of operation program error detected 
by the OU task during processing of an operation block. 
Refer to the Channel Theory-Maintenance manual. 


Device Errors 


Device errors occur during the execution of an |/O 
command contained in a function operation block. A 
device error causes the device to supply a command 
end completion indication to its OU task and to provide 
status associated with the error condition in a 2-byte 
basic status field. (See Basic Status earlier in this 
chapter.) 


Additional status information is available to the IOM in 
the form of device status fields. (See Device Status 
earlier in this chapter.) 


Operational Unit Error Recovery 


Operational unit recovery procedures must be initiated 
by an IOM (I/O manager) whenever the IOM is notified 
of either a device error, an operation program error, or a 
channel-detected error. The associated operational unit 
task resides in the receive-wait state on the QCT-SRC 
(queue control table, send/receive counter) queue and 
must be cleared for further operational unit activity. 


The |OM must proceed as follows: 
1. Lock the QCT. 


2. Test FOB (function operation block) in-use bit. 

a. If set, form a command-end function event, 
place the function event on the QCT event 
stack, and issue a send count to the QCT-SRC. 
This sequence, in effect, redispatches the OU 
task and supplies it with an |OM-formed work 
request. 

b. If not set, test for OU (operational unit) task in 
receive-wait state on the QCT-SRC queue. 


If the OU task is on the QCT-SRC queue, then 
form a fetch next command function event. Place 
the function event on QCT event stack and issue a 
send count to the QCT-SRC. If the OU task is not 
on the QCT-SRC, then continue. 


3. Unlock the QCT. 


Operation Program Error Recording 


Defined operation program errors common to all IOMs 


9 


are shown in Figure 7-8. The table defines the ie, ) 


code i error name error class El record type 
retry limit 6 | and the priority in which the error 
should be decoded from the status information. The 
method of handling temporary retryable errors is also 
defined. They may be counted in a storage data register 
counter and not logged (x in count-only column). All 
errors that cause an entry into retry may be logged (x in 
log all column) or they may be thresholded (threshold 


value in threshold limit column) and counted in a storage 


data register counter. An x in the count-retryable 
column indicates that the total number of retries should 
be counted in a storage data register counter for this 
error. 


The error recovery action required and the error log 
format for the error are also referenced. 


C 


Error Definition 














Record “a romper Retry Errors 
Error Retry 
Code | Error Name rs] Temp- a | 
a orary | Count Count 17 
Record | Record| Retry | Only imi ‘Retry 





Operation error—Channel busy 
Operation program error 





Figure 7-8. Operation Program Errors 


The description of each error in terms of OU-status 


bytes and bits is shown in Figure 7-9. 
Recovery 
FOB Bytes Action Error 
Oper-| Pro- | Log 
| Byeo 0 | Byte 1 1 ation | gram Format 


07 
XX 


Legend: Byte = 40 means high-order hex digit = 4 
low-order hex digit = O 
Byte = xx means may be any value 
Recovery = Error recovery procedures 


Error Definition 














Error Description 






Operation error—Channel busy 
Operation program error 


Figure 7-9. Error Descriptions 
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Error Recovery Procedures 


Repeat the command up to 5 times. If the condition 
persists after 5 unsuccessful retries, log the error. |OM 
then must initiate error recovery (described in Operational 
Unit Error Recovery earlier in this chapter). 


The error log format for the OU-IOM is the same for all 
operation program errors logged. See the Channel 
Theory-Maintenance manual for the format description. 


CHANNEL ERRORS 


Channel errors are an error class encountered during the 
operation of a device on the channel interface. A 
channel error causes the device to cease all operation, 
and an error event field (refer to !/O Event Stack, earlier 
in this chapter) containing all available status information 
is passed to the channel IOM (1/O manager) task. 
Channel errors fall into three subclasses: channel 
hardware error, |/O event handler error, and a special 
class of device error report using the post event 
function. The post event function is used by a device to 
communicate error status to its IOM via the channel 
IOM. 


The event field format for each subclass is as follows 
with each type of channel error described in detail in the 
Channel Theory-Maintenance manual. 
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Channel Hardware Error 


















1/0 Channel 
Register Priority 
Number Code 





d1dddddd 
0 


Bytes 1 2 


Legend: d = Device dependent 


ppppss00 
3 
p = Primary channel error code 


s = Secondary channel error code 
0001 
or 
Event Handler Error 1111 


aaaaaaaa adaaaaaa 


alaaaaaa 





QO = ©Bytes 1 2 3 


Legend: a= Depends on the event type processed, see the 
Channe/ Theory-Maintenance manual for 
specifics. 


b = Event handler error code 


Post Event 


Operational 
Unit ddddddyz 


Reporting 


1/0 


Register 





QO Bytes 1 2 3 


Legend: d = Device-dependent information provided by the device 
y (bit 6) = Post event type 
O Error condition detected in adapter and/or 
device which cannot be reported via a normal 
BSTAT. 
1 Attention request to OU-IOM. 
z (bit 7) = OU type 
O Single OU reporting, that is, OU number in byte 
2 of post event defines a unique reporting OU. 
1 Multiple OUs reporting, that is, OU number in 
byte 2 of post event is reporting for all OUs 
attached to a particular I/O port. 





Channel Error Reporting 


The active device at the time of the error has its 
operation suspended until the error is resolved. The 
error must be posted to the channel I|OM and 
notification given to the operational unit IOM that a 


channel error has occurred and the device halted. The 

|/O event handler moves the error event field data from 
the |/O event stack (see Figure 7-7) to the QCT (queue 
control table) event stack of the channel OU (operational 


unit). A Send Count instruction to the SRC 
(send/receive counter) of the channel OU-QCT then 
signals the channel OU task. The channel OU task 
sends the ORE (operation request element) containing 
the error event to the I|OMQ for the channel IOM. 


The channel IOM notifies the operational unit |OM that a 
channel error has occurred and the device is halted. The 
operational units IOM now proceeds as described under 


Operational Unit Error Recovery earlier in this chapter. 


Channel Error Recovery 


Four FOB (function operation block) commands allow 
the channel IOM access to the channel hardware to 
perform |/O error recovery operations. 


The channel |OM communicates with the channel 
hardware via an OU and IOM queue pair. An OU 


(operational unit) of hex OO is used for FOB commands 


directed to the first hardware channel on the system. 


The channel FOB commands are decoded and executed 


by the OU task servicing the OU queue used by the 
channel error IOM. 


Start Channel (hex 11) 


The start channel FOB command can be used at 
IMPL or following a secondary channel error 
condition that caused the channel hardware to stop. 
The start channel command causes the channel OU 
task to reset the secondary error stop bit. in register 
EO (hardware register), which causes the channel 
hardware to log the 4-byte event field in the 
hardware into the |/O event stack. The secondary 
error stop bit is then set to force the channel 
hardware to stop on the next secondary error 
condition. 


The channel OU task next issues a Receive Count 
instruction to the SRC in the channel OU task control 
table. When the |/O event handler services the |/O 
event stack and issues a Send Count instruction to 
the QCT of the channel OU task, the OU task 
removes the event from the QCT event stack and 
places the 4-byte field into FOB bytes hex C-F. 
Following the read event operation, the 
command-complete bit in the OU status field of the 
ORE is set and the FOB. is completed. 


Note: The event field obtained during the start 
channel FOB is normally the event field maintained in 
the channel hardware when a secondary error is 
detected. However, because the event fields are 
removed from the event stack on a last in, first out 
manner, any event fields posted by |/O devices 
between the time the channel hardware starts and 
the channel OU task is dispatched can be returned 
prior to the secondary error event field. 
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e Start Device (hex 12) 


The start device FOB command causes a start device 
channel sequence. The start device channel sequence 
is normally used by an OU task, during the 
processing of an FOB block, to notify an |/O device 
that a command is available for execution. Depending 
on the device implementation of the channel 
sequence, the command information in the FOB may 
be transferred to the device during the start device 
sequence. 


The device address to be used during the channel 
sequence is provided in byte hex C of the FOB. The 
command complete bit in the OU status field of the 
ORE is set upon successful completion of the FOB. 


e Halt Device (hex 21) 


The halt device command is similar to the start 
device command in that an |/O device attached to 
the channel is selected by a broadcast of the device 
address provided in byte hex C of the FOB. The halt 
device cemmand issues a halt condition to the 
selected device to cause termination of any active 
command. 


Completion of the halt device command is indicated 
by the command-complete bit in the OU status field 
of the ORE being set. 


e Read Event (hex 22) 


The read event command is used by the channel 
error |OM to obtain events from the channel IOM 
QCT event stack. The read event causes the OU task 
servicing the channel IOM to issue a Receive Count 
instruction to the SRC in the queue coatrol table. If 
no events are on the QCT event stack, a task switch 
occurs with the OU task waiting for a Send Count 
instruction from the |/O event handler. 


If event fields are in the QCT event stack, or when 
the OU task is dispatched by a Send Count 
instruction to the SRC, an event field is removed 
from the QCT event stack in a first in, first out 
manner and placed in FOB bytes hex C-F. 


The read event command is completed by setting the 


command complete bit in the OU status field of the 
ORE. 
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Channel Error Recording 


Error Definition 


Errors defined for the channel are the error code, error 
name, error class, record type, retry limit, and the 
priority in which the error should be decoded from the 
status information. The method of handling temporary 
retryable errors is also defined. They may be counted in 
a storage data register counter and not logged. All 
errors that cause an entry into retry may be logged or 
they may be thresholded and counted in an SDR 
counter. See the Channel Theory-Maintenance manual for 
specific error codes. 


Error Recovery Procedures 


1. Repeat the command up to five times. If the 
condition persists after five unsuccessful retries, 
perform a Terminate Immediately instruction. 
Operator panel light-emitting diode readout = hex 
0832. 


2: Perform a Terminate Immediately instruction. 


3. Issue an AOB (address operation block) to read 
IORAR O (I/O resolved address register 0). If 
offset of IORAR is 512 bytes from the beginning 
address, or if retry fails, perform a Terminate 
Immediately Instruction. Operator panel 
light-emitting diode readout = hex 0831. 
Otherwise, issue a start channel FOB (furction 
operation block). 


4. Log the error. There is no recovery since the |/O 
adapter is not uniquely known. 


5. Send a message containing the post event field 
(bytes hex C-F of read event fiela FOB) to [OM 
(1/O manager) servicing the OU (operational unit) 
whose number is contained in byte hex E of the 
read event FOB. In the event that byte hex E 
contains an OU number that is currently inactive or 
invalid, then log the error. 


J 


6. Log the error and send message containing error 
event field (bytes hex C-F of read event FOB) to 
the IOM servicing the OU having the IORAR 
contained in byte hex E of the read event FOB. 


vi Log the error and send message containing error 
event field (bytes hex C-F of read event FOB) to 
the IOM servicing the OU having the IORAR 
contained in byte hex D of the read event FOB. 


8. Log the error and send message containing error 
event field (bytes hex C-F of read event FOB) to 
the I|OM servicing the OU whose IORAR and 
channel priority code match respectively bytes hex 
D and E of the read event FOB. 


9. Log the error and send message containing error 
event field (bytes hex C-F of read event FOB) to 
the IOM servicing the OU having the IORAR 
contained in byte hex E of the read event FOB. 


Error Log Format: 


The error log format for the channel has the same 
format for all errors logged. See the Channel 
Theory~-Maintenance manual for the formats and error 
descriptions. 


DEVICE HALT 


During the execution of an ORE (operation request 
element) by an OU (operational unit), the device IOM 
([/O manager) task can terminate execution of the ORE. 
This is accomplished by the device IOM task requesting 
the channel IOM task to perform a halt device function. 
The following occurs: 


e« The channel IOM sends a message (ORE) to the 
channel OUQ (operational unit queue). The ORE 
contains an FOB with a command byte of halt device 
(hex 21) and with the OU number of the device to be 
halted in byte hex C. 


e The channel OU task services the channel OUQ and 
passes the command to the channel hardware, which 
issues a halt to the selected device. 


« The channel OU task accepts the device’s response 
to the channel as a device command completion 
indication and sends an ORE containing completion 
indication to the I|OMQ of the channel IOM. 
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The device OU task has not received indication of the 
termination of the ORE. The OU task resides on the 
wait list of the QCT-SRC of the operational unit in the 
recieve wait state. To clear this state requires action by 
both the channel |OM and device IOM tasks: 


e The channel IOM forms an |/O event field (see 
Figure 7-7) of the function event type (command 
end) as follows: 


ie | | 
1 2 3 


O Bytes 
« The |/O event field is placed on the operational unit 
QCT event stack, and a Send Count instruction is 
issued to the QCT-SRC of the operational unit. 





« The device |OM forms an |/O event field of the 
function event type (fetch next command) and places 
it on the OQU-QCT event stack. A Send Count 
instruction is issued to the QCT-SRC of the OU. 


« The OU task is now placed on the TDQ in priority 
sequence. 
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Chapter 8. Virtual Storage Addressing 


The following addresses are virtual: 


« All addresses used by the processor in executing 
instructions or fetching data operands. 


« All storage addresses that are explicitly specified by 
an IMP (internal microprogramming) instruction and 
are used by the processor. 


« The address(es) indicated to the processor on an 
exception or as the result of executing an instruction. 


- All storage addresses explicitly specified in 1/O 
messages. 


The complete virtual address of any byte of storage is a 
48-bit address as shown below. 


Segment Identifier Offset 





0 Bits 32 47 


The 48-bit virtual address is translated by the processor 
into a real storage address using the VAT (virtual 
address translator) facility described in the following 
paragraphs. 
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Virtual Address Translator Overview 


The VAT facilities: 


¢ Translate virtual storage addresses to real storage 
addresses; or, when that translation cannot be 
completed, 


« Interrupt the execution of IMP instructions, which 
allows: 
— Invocation of storage management functions, 
which 
— Alters the contents of real storage, which allows 
— Continuation of processing 


TRANSLATION PROCESS 


During translation, two units of information are 
recognized—segments and pages. A segment is a block 
of sequential virtual addresses spanning up to 65 536 
(216) bytes. A page is a block of sequential virtual 
addresses and contiguous storage locations containing 
512 bytes beginning at a virtual address that is a 
multiple of the page size. All pages in storage are the 
same size. 


The 48-bit virtual address logically is divided into two 


parts. Bits 0-31 are used as an SID (segment identifier). 


Bits 32-47 are used to provide an offset to data within 
the segment. For translation to main storage addresses, 
bits 32-38 are used as a PID (page identifier). The 
remaining bits of offset are used as a BID (byte 
identifier) within a page. See the following diagram. 


Segment Identifier Offset 


0 Bits 32 39 47 


Translation is achieved by means of translation tables. 
Each table entry describes a block of consecutive real 
storage locations. Each such block is called a page 
frame. Each page frame contains a page of instructions 
or data. 


The method used by the virtual address translator to 
translate a virtual address to a real storage address 
depends on the value of the virtual address. Virtual 
addresses, when they are within the SID (segment 
identifier) range shown below, are converted to real 
storage addresses by selecting the appropriate bits. 








V=R Address SID Selected 


System 

Unit Range (Hex) Bits 

5381 3,4, 5 0000 0100 - 0000 27-47 
011F 

6, 7, 8 0000 0100 - 0000 24-47 

O1FF 

5382 All 0000 0100 - 0000 22-47 
O2FF 


This ts referred to as virtual = real addressing. Those 
virtual addresses not in the virtual = real addressing 
range are referred to as a virtual = virtual addresses, and 
are translated to real addresses by means of the PD 
(primary directory). If the resultant real address is too 
large for a particular available main storage size, an 
addressing exception results. 










The assignment of storage occurs in page-size blocks; 
the storage locations are assigned contiguously within a 
page. Two pages need not be adjacent in storage 
(unless they are virtual = real) even though assigned a 
set of sequential virtual addresses. 


The SID and PID portion of a 48-bit virtual address to 
be translated by means of the PD are used to select an 
entry from the PD. The PD entry, whose format is 
described later in this chapter, contains information that 
specifies one of the following actions: 


- If the PD entry describes a page frame of storage 
that contains the page whose SID and PID match 
that of the address to be translated, the storage 
address is formed from this PD entry. 


e If the PD entry does not describe such a page frame 
of storage, advance to and examine another PD entry. 


e lf there are no more PD entries to examine, signal an 
address translation exception. 





2 





Virtual-to-Real Address Translation 






ik 


ae Primary 
elector Directory! (PD) 
Hash 
Table! 


| 
| 
| 
| 
LB Selector 
(tssiecer / 


Lookaside 
Buffer (LB) 






Storage 
Address 





'In Storage 


1 | Information extracted from the virtual address is 
used to search the LB. 


p22 Information extracted from the virtual address is 
used to search the PD. 


If no match exists in the LB, the PD in storage 
is searched to translate the address. If a match 
exists, the information is used to form an entry 
in the LB. 


Programming Note: The primary directory and hash 
table for storage are in a virtual = real segment in 
storage, and can be accessed by the IMP instructions. 
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Virtual Address Translator Components 


Address translation is performed by means of the HT 
(hash table), the PD (primary directory), and the 
high-speed LB (lookaside buffer). 


The HT and the PD reside in storage and can be 
accessed by the IMP instructions. Their structure and 
functional characteristics are described in this section. 
Also discussed are the functional characteristics of the 
LB, which does not reside in storage and whose 
contents cannot be accessed as data by the IMP 
instructions. 


CONTROL INFORMATION 


The address of the first HT entry and the address of the 
first entry in the PD directory are in the control address 
table. The sizes (the number of entries-1) of the HT and 
the PD are also contained in the control address table. 
These fields are used by the processor during IMPL. 
They can be accessed or modified at any time by IMP 
instructions, but any changes do not affect the address 
translation process. 


HASH TABLE 


An entry fetched from the HT provides an index into the 
PD. The number of hash table entries varies, as the 


following chart shows: 
Number of Entries 


System 
Unit Model (In Powers-of-2 Increments) 


5381 256 - 32 768 


6, 7, 8 256 - 65 536 


5382 All 256 - 65 536 


The number of entries is controlled by the HT size field. 
Generally the hash table should contain at least two 
entries for every PD entry in order to control the length 
of PD entry chains. The number of HT entries must be 
a power of 2. Each entry has 16 bits of data. 







The HT entries occupy contiguous storage beginning at 
the address specified by the HT address field. The hash 
table must be aligned on a segment boundary. For 
Models 3, 4, and 5, the table must be within one virtual 
virtual = real segment. For the the 5381 System Unit, 
Models 6, 7, and 8, and for all 5382 System Unit 
models, the hash table may cross a segment boundary 
but must be within two virtual = real segments. 
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An entry value of zeros indicates an end-of-chain 
condition. 


J 


Hash Table Entry Format 


0 Bits 16 


Hash Table Lookup 


The processor accesses the HT in storage as part of the 
address translation process. The SID and PID portion of 
the virtual address are used to select an entry from the 
HT. The value of the selected HT entry is used to select 
a PD entry. 


A 16-bit HT entry index value is generated from the 
virtual address by address compression (hashing) of the 
39-bit field formed by linking the SID to the PID. The 
number of significant bits in the result is controlled by 
the hash table size field. The hash table entry index 
value is used to select a hash table entry. Hashing is 
shown in the following diagram and is described in the 
following text: 

The PID bits (32-38 of the virtual address) € are 2 
reversed (38-32) @ then shifted right once for each 

zero bit in the HT size register, plus one. 


Bytes 1 and 2 of the SID are © exclusively ORed with 
bytes 2 and 3 of the SID and then exclusively ORed 
with the result of the reversed and shifted PID bits. The 
shifted data is then ANDed with the halfword HT 
size register (from the control address table). This 
ANDing causes the hash on the left to be truncated so 
that the result has the same size specified by the HT 
size register. The result @ is shifted left 1 bit position. 


The result is F added to the beginning address of the 
hash table. The sum © is used as an entry into the 
hash table. 


The virtual address of the selected HT entry is obtained 
by adding bits 0-15 of the index to bit 31-46 of the 
virtual address of the HT (as given in the HT address 
fieid). Bit O of the HT index is ignored (on Models 3, 4, 
and 5) and treated as O, and low-order bit 47 is forced 
te O. 





Virtual Address 


Hash Table 
Size Register 


O Bytes 1 2 3 4 5 


Bytes Bits 32—38 
Bytes 2 and 3 


1 and 2 
Shift 


\ 
Reverse Order of Bits 
Right 
Control 
Shift Register A |@ 










Shift control to align 
reverse-ordered bits 

with most significant 
bit of hash table size 
register mask data 


Shift Left 


One Positi 
Starting eo Shift Register C @ 
Address of 


Hash Table 


Adder 


Hash Table 
Entry Address 
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As part of the hash table lookup process, the index is 4 
tested for a value of all-zeros (end-of-chain). If J 
nonzero, the index field is used to access an entry in the 

primary directory. The virtual address of the PD entry is 

obtained by adding the 16-bit hash table entry to bits 

28-43 of the virtual address of the primary directory. 

The low-order 4 bits (44-47) are forced to zeros. The 

control address table contains the address of the 

primary directory. Bits O-3 of the PD index are ignored 

and treated as zeros (Models 3, 4, and 5 only). 


A VMC program can use the HVVA (Hash and Verify 
Virtual Address) instruction and the LHTEA (Load Hash 
Table Entry Address) instruction to access a HT entry in 
the same way that the processor accesses HT entries. 
See Chapter 10 for a discussion of this instruction. 


PRIMARY DIRECTORY 


One PD (primary directory) entry is provided for each 

frame of main storage installed on the system. A PD 

entry fetched from the PD (primary directory) indicates 

the virtual address of the page stored in the block of 

storage represented by the PD entry and the status of 

the page. Linkage to other PD entries is also provided. ; 
Each PD entry contains 16 bytes of data. There can be 2 
1 to 65 536 entries, in power-of-2 increments. 


The PD entries occupy contiguous storage beginning at 
the address specified by the PD address field. For 
Models 3, 4, and 5 the primary directory must be 
S|ID-aligned and may not cross a segment boundary. 
For Models 6, 7, and 8 the primary directory may cross 
segment boundaries but must not exceed 16 virtual = 
real segments. 


Primary Directory Entry Format 


Not 
Used 
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8~6 


C 


The fields are allocated as follows: 


Bytes 
(Hex) Bits 


0-3 


Bytes 
(Hex) Bits 


Description 2 


SID: Segment identifier of the page 
stored in this block of storage. The 
SID field is compared against bits 
O-31 of the virtual address to be 
translated. 


PID: Page identifier of the page 
stored in this block of storage. The 
PID field is compared against bits 
32-38 of the virtual address to be 
translated. Bit 39 must be zero. 


Status: Information about the page. 


Valid: This bit can be set by the 
VMC and should be reset by only 
the Invalidate Primary Directory 
Entry and Examine Primary Directory 
Entry instructions. 


QO Page described by this PD 
entry is not available for 
access. An address translation 3-4 
exception is recognized and 
the operation being attempted 


is nullified. 

1 Page described by this PD 5-7 
entry is available for access. 
Address transiation proceeds, 6-7 0-15 


using the PD entry. 


Reference: This bit is set whenever 
the corresponding non V=R page 
frame is accessed by the processor 
and the corresponding entry is not in 
the lookaside buffer, or when an 

|/O operation requires use of the 8 
address. This bit should only be 
reset by the Read Reference and 
Change and Reset Reference 
instruction, and in some cases, by 
an Examine Primary Directory Entry 
instruction. 


O Page has not been referred to. 


1 Page has been referred to. 


Description 


Change: This bit is updated (ORed 
with the change bit in the lookaside 
buffer) when the corresponding 
lookaside buffer entry is removed by 
the processor updating the lookaside 
buffer; by an Invalidate Primary 
Directory Entry instruction, a Read 
Reference and Change and Reset 
Reference instruction, or in some 
cases, an Examine Primary Directory 
Entry instruction; or when an I/O 
operation is started which will store 
into the associated non V=R page 
frame. This bit is reset by the VMC. 





Note: The lookaside buffer change 
bit is set whenever the processor 
stores data in to the associated non 
V=R page frame. 


O Page has not been changed. 
1 Page has been changed. 


|/O Used by the processor when 
the page is being used by the I/O. 
The bits are both set and reset by 
the processor. 


Reserved: Must be zeros. 


Index: Index for the next PD entry 
in this chain of PD entries. The 
value of the index field is used by 
the processor to access the next PD 
entry in a chain of eniries. An 
all-zero value indicates an 
end-of-chain condition. 


PINCNT: A 1-byte use counter for 
pinning (holding) pages in storage. 
A nonzero value indicates that the 
page is in use and should not be 
removed from storage. The counter 
can be updated by either the IMP 
task or the processor. | 
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Bytes 
(Hex) Bits Description 
9 Status: Provides page status 
information, and is defined and 
maintained by the vertical 
microcode. 
0 Not used. 
1 Purge indicator set/reset by EPDE. 
2 Not used. 
3 Write pending. 
4 Access pending. 
5 Faulty page. 
6 Nucleus. 
7 Virtual=Real page. 
A Not used. 
B Usage Code Byte: Maintained by 
the vertical microcode. 
0-1 Not used. 
2 Usage code. 
3-7 Not used. 
C-F Not used. 


Programming Note: The processor sets the reference 
and change bits. The Read Reference and Change and 
Reset Reference instruction resets the reference bit. The 
program must reset the change bit. 


Primary Directory Lookup 
> 


The processor accesses the PD in storage as part of the 
address translation process. 


The SID and PID portion of the virtual address are used 
to select a PD entry as previously described in this 
chapter under Translation Process. The PD entry fetched 
from the primary directory indicates the virtual address 
and status of the page described. The SID of the virtual 
address to be translated is compared to the SID of the 
page stored in the page frame of storage described by 
the fetched PD entry. Bits 0-31 of the PD entry are 
compared to the SID of the virtual address to be 
translated. 


Bits 32-38 of the PD entry are compared to the PID of 
the virtual address to be translated. If a match occurs 
and bit 40 is 1, this page is available for access. The 
storage page address may be formed as described in 
Storage Address Formation in this chapter. If a match 
occurs and bit 40 is O, an address translation exception 
occurs, and the operation being attempted is nullified. 


If no match occurs, the index field is tested for O. If this 

field is O, an address translation exception occurs; if the 

field is not 0, the index field is used to access another i. 
PD entry. The virtual address of the PD entry is 2 
obtained by multiplying the index field by 16 and adding 

the resultant 20-bit offset to the address of the PD. On 

Models 3, 4, and 5, the high-order 4 bits of this 20-bit 

offset must be zeros. The PD address must be 

S|ID-aligned and is obtained from the PD address field 

of the control address table. 


When a virtual address is used in an |/O operation, the 
PINCNT field in the PD entry for that address is 
incremented by the processor. When the |/O operation 
is completed, the processor decrements the PINCNT 
field. This ensures that an IMP task does not invalidate 
the PD entry in the middle of an |/O operation. 


When the next *?D entry has been fetched, all tests and 
steps described for the first PD entry of the chain are 
performed. The lookup operation continues from entry 
to entry until encountering either a PD entry with a 
matching virtual address or a nonmatching virtual 
address and zero index value, indicating an end of chain. 


Storage Address Formation 


When a PD entry is found that contains a virtual address 
matching the address to be translated and the page is 
available for access (bit 40 = 1), the storage address is 
formed. The processor uses bits 0-15 of the index 
value pointing at the current PD entry as the page frame 
identifier and 9 bits of the BID (byte identifier) from the 
virtual address to be translated in forming the storage 
address. The BID is concatenated to the right of the 
page frame identifier to provide 25 bits of storage 
address. 


LOOKASIDE BUFFER 


To enhance performance, the VAT facility is 
implemented so that some of the information specified 
in the primary directory in storage is also maintained by 
the processor in a special buffer called the LB (lookaside 
buffer). The processor refers to a PD entry in main 
storage for the initial access to the entry, then maintains 
the information in the lookaside buffer. All subsequent 
translations involving PD entries from the same real 
storage page frame can use the information recorded in 
the lookaside buffer. 


The presence of the lookaside buffer affects the 
translation process in that a modification of the contents 
of a PD entry in storage does not have an immediate 
effect on the translation. Also, changes to the reference 
and change status of a page are not immediately visible 
in the PD entry in storage if address translation is 
accomplished using the lookaside buffer. 


The LB entries are not explicitly addressed by IMP 
instructions, nor can information be explicitly entered 
into the lookaside buffer by executing IMP instructions. 
How the reference and change bits can be read out and 
how entries can be removed by executing IMP 
instructions is described in the next topic. Entries are 
implicitly added to and removed from the lookaside 
buffer by the translation process explained in Translation 
Process earlier in this chapter. A copy of a PD entry is 
placed in the lookaside buffer only when the valid status 
bit of the PD entry is 1. An address translation 
exception is recognized when an attempt is made to use 
an invalid PD entry for translation. 


When a copy of a PD entry exists in the lookaside 
buffer, the PD entry is said to be active. The LB entry 
copy of a PD entry can be implicitly removed from the 
lookaside buffer by the processor to fulfill subsequent 
translations involving other PD entries. Once the LB 
entry copy is removed from the lookaside buffer, the PD 
entry is said to be inactive. No status bit is provided to 
show the active-inactive state of a PD entry. When an 
active PD entry becomes inactive, the reference and 
change status bit of the page is updated in the PD entry 
to reflect the most recent active status of the page. 


Reference and change recording takes place for any 
storage access made by the processor and |/O 
operations unless the |/O operation uses virtual = real 
addresses. Hence, references to a storage location 
associated with |/O operations are included. 


The change bit is not turned on for an attempt to store 
if the storage reference is not permitted, regardless of 
whether the IMP instruction responsible for the 
reference is suppressed or terminated. In particular, a 
processor reference causing an addressing or address 
translation exception does not cause the change bit to 
be turned on. 
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VAT Component Maintenance 


The VAT (virtual address translator) components in 
storage—the control information, the HT (hash table), and 
the PD (primary directory)—can be accessed and 
modified by IMP instructions. Control information 
modification is discussed in Control! Information under 
Virtual Address Translator Components in this chapter. 
This paragraph describes the effects of any manipulation 
of an HT or PD entry by IMP instructions and the 
relationship of changes in the primary directory to 
changes in the LB (lookaside buffer). 


MODIFICATION OF HASH TABLE ENTRIES 


The effects of changes to an HT entry depend on the 
status of any associated PD entries; that is, a PD entry 
indexed by the HT entry or any PD entries connected to 
that PD entry by chaining. See the next topic for a 
description of the status of PD entries. 


A change to an HT entry associated with inactive PD 
entries takes place immediately. A change to an HT 
entry associated with active PD entries can take effect 
for implicit translation any time after the instant of 
change (when the entry becomes inactive). 


Programming Note: Manipulation of an HT entry 
associated with active PD entries can produce 
unpredictable results. Prior to changes, all associated 
PD entries should be made inactive and invalid. See the 
next topic. 


MODIFICATION OF PRIMARY DIRECTORY ENTRIES 


Entries in the storage PD can be accessed and modified 
by IMP instructions. The effects of any manipulation by 
an IMP instruction of a PD entry and the recording of its 
contents in the LB (lookaside buffer) depend on whether 
the entry is valid and whether a copy of the entry exists 
in the LB; that is, whether the PD entry is active. 


When an inactive, invalid PD entry is made valid, the 
change to valid takes place immediately. Also, when an 
inactive, valid PD entry is made invalid, the change to 
invalid takes place immediately. 


A change to an active PD entry, one for which a copy 
exists in LB, can take effect for implicit translation any 2 
time after the instant of the change (when the entry 

becomes inactive). An Invalidate Primary Directory Entry 

instruction is used to invalidate a PD entry (see Chapter 

10). 


REFERENCE AND CHANGE RECORDING 


Reference recording provides information for use in 
selecting storage blocks for page replacement. Change 
recording provides information as to which pages have 
to be saved in backing storage when they are replaced 
in storage by new pages. Both reference and change 
recording are done by the processor as part of virtual 
address translation. 


PD entry bit 41, the reference bit, is set each time the 
entry goes from the inactive state to the active state. 
This occurs whenever the entry is inactive when a 
location in the page contained in the corresponding page 
frame is referred to for either the storing or fetching of 
information. The PD entry bit 42, the change bit, is set 
each time information is stored in the corresponding 
page contained in that page frame. 


q 
Change recording in the primary directory is accurate 2) 
only for inactive PD entries. After the initial reference to 
a page, address translation is performed by means of 
references to the LB. Change recording takes place in 
the LB without corresponding updates of the change bit 
in the PD entry in storage until such time as that PD 
entry becomes inactive. 


An active PD entry becomes inactive when it is purged 
from the lookaside buffer. It can be made inactive 
implicitly by the processor as a result of translations 
involving other PD entries, and explicitly by executing an 
Invalidate Primary Directory Entry instruction, a Read 
Reference and Change and Reset Reference instruction, 
or in some cases, an Examine Primary Directory Entry 
instruction (see Chapter 10). 


The current state of the reference and change bits can 
be obtained for any PD entry by executing a Read 
Reference and Change and Reset Reference instruction 
(see Chapter 10). 





Chapter 9. Machine Support Functions 


This section provides detailed descriptions of certain 
facilities of VMC (vertical microcode) that enhance the 
efficiency, utility, and programmability of the machine. 
Included are the facilities for IMPL (initial microprogram 
load), monitoring, timers, machine control, and machine 
check. 
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Initial Microprogram Load 


Initial microprogram load (IMPL) provides for the 
initiation of processing when the contents of storage are 
not suitable for processing. Invoking the IMPL function 
causes information to be read from a selected input 
device (usually the disk file), into preassigned storage 
locations. The information read in is the minimum 
amount required to execute an IMP task. The IMPL. 
function can be invoked whenever system power is up. 


The IMPL function is started by the hardware/HMC 
(horizontal microcode) and is completed by the IMP. 
This document addresses only the HMC portion and the 
transition to the VMC portion. 


IMPL in hardware/HMC performs three functions: (1) 
some basic hardware tests and initialization; (2) loading 
of control storage and a small portion of main storage; 
and (3) HMC initialization. Several 

initialization /configuration parameters are required by 
these functions and are stored on the IMPL device. 
Function 1 requires main storage and control storage 
configuration parameters. Function 2 requires the size of 
the VMC load to be stored in main storage. Function 3 
requires the following parameters to be stored at known 
locations within the VMC load (see the control address 
table described in Figure 2-2): valid addresses for the 
PD (primary directory), the HT (hash table), and the 
HMC overlay area and size parameters for the PD and 
the HT. 


As part of the hardware test, main storage is 
functionally tested. Any page frame found to be failing 
will be flagged invalid in the main storage defective 
frame table. Previously defective pages, as logged in the 
main storage history table (cylinder 0, head O, sector 3 
of the file) are flagged in the main storage defective 
frame table. A swap is made, if necessary, to ensure 
that the VMC nucleus area contains no defective frames. 
The main storage status word is updated showing 
whether a swap was performed. If a defect-free VMC 
nucleus area cannot be attained, the system halts and 
the sequence indicator lights on the CE/Op panel are lit. 
The main storage defective frame table contains 512 
bytes in Models 3, 4, and 5; 1024 bytes in Models 6 
and 7; and, 2048 bytes in Model 8. Each bit represents 
one main storage page frame (hex O bit = good, hex 1 
bit = defective). The address of the main storage 
defective frame table is found in the control address 
table (see Figure 2-2) at SID (segment identifier) hex 
0000 0100 offset hex 0002-0007. 


The transition after the HMC initialization to the VMC 
code (part of the VMC load) is accomplished by the 
HMC task dispatcher code switching to the VMC IMPL 
task code. Required to accomplish this are two 
addresses in the control address table and a 
preinitialized TDQ (task dispatching queue) and TDE 
(task dispatching element). The two addresses needed 
are for the TDQ and any current TDE address. The 
preinitialized TDQ contains a pointer to the preinitialized 
TDE belonging to the VMC IMPL task. This TDE is 
preinitialized as follows: no pending exceptions; ILC 
(instruction length count) equal to zero and CC equal to 
zero (hex O8); initial values for all 16 IMP base registers 
(base register O must point to the VMC IMP task code 
space); and an IAR (instruction address register) value 
pointing to the first VMC instruction to be executed. 





> 





Program Event Monitoring 


A program event is recognized whenever the task 
dispatcher is enabled and the microprocessor determines 
that the initial byte of an instruction is located within a 
particular range of virtual addresses. The range is 
specified by the PEM (program event monitor) start 
address and PEM stop address fields of the TDE (task 
dispatching element). Bytes C-D (control mode), bit 6 of 
the TDE selectively enables or disables the PEM range 
check performed while fetching each successive IMP 
instruction. 


Once a task has been dispatched, alteration of bit 6 is 
not detected until the task is dispatched at a later time. 
The PEM range is not checked if the instruction is 
altered by an Execute instruction. 


A PEM exception is presented as follows: 


» If bit 8 of the TDE exception mask field ig 1, the 
instruction is nullified and the exception SVL 
(supervisor linkage) mechanism is invoked. 


If bit 8 is O, it is set to 1; no exception is generated. 
The instruction is completed and the next instruction 
is fetched and checked for being within the PEM 
range. 





This allows the PEM IMP exception handler to cause a 
nullified instruction to be completed without altering the 
PEM start and stop addresses in the TDE. 


Programming Note: A Dispatch Task Dispatching Queue 
instruction can be used to cause bit 6 of the TDE 
control mode field to be reinspected or to raload the 
PEM registers from the TDE. 
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Internal Microprogramming Timer 
Support 


The processor provides these support timing functions: 
a time-of-day clock, a clock comparator, and two 
interval timers. 


TIME-OF-DAY CLOCK 


The time-of-day clock provides date and time. The 
cycle of the clock is approximately 143 years. 


The time-of-day clock is a binary counter with a format 
as shown in the following figure. The bit positions of 
the clock are numbered O to 63, corresponding to the 
bit positions of an unsigned binary doubleword. Time is 
measured by incrementing the value of the clock, 
following the rules for unsigned binary arithmetic. 


Time Value 
0 Bits 42 56 63 


The clock is incremented by adding a 1 in bit position 
41 every 1024 microseconds. When incrementing of the 
clock causes a Carry out of bit position O, the carry is 
ignored and counting continues from zero. No exception 
condition is generated as a result of the overflow. 


The clock can be inspected by means of the instruction, 
Store Time-of-Day Clock, which causes the bits 
corresponding to the bits being updated to be stored. In 
order to ensure that successive executions do not 
provide the same clock value, the Store Time-of-Day 
Clock instruction causes a one bit to be added to bit 
position 63 every time the instruction is executed. Any 
carry from bit position 56 is ignored. Thus, the 
rightmost 8 bits of the stored value contain a number 
that is used to provide uniqueness and is not a part of 
the actual clock value. 


9-4 





The clock can be set to a specific value by means of the 
Set Time-of-Day Clock instruction, which causes bits 
corresponding to the bits being updated to be replaced 
with the operand designated by the instruction. If a 
Store Time-of-Day Clock instruction is issued before 
the Set Time-of-Day Clock instruction, an unpredictable 
result is stored. 


CLOCK COMPARATOR 


The clock comparator provides a means of determining 
when the TOD (time-of-day) clock has passed a 
specified value. The clock comparator has the same 
format as the TOD clock, and only those bits that 
correspond to the clock bits being incremented 
participate in the compare. 


The clock comparator can be inspected by means of the 
Store Clock Comparator instruction and can be set to a 
specific value by means of the Set Clock Comparator 
instruction. The address of the location of the target 
send/receive counter, when the time-of-day clock value 
is equal to or greater than the specified value, is 
contained in the control address table shown in Figure 
2-2. The results of a compare are unpredictable if a Set 
Clock Comparator instruction is issued before the TOD 
clock is set. If the value specified in the Set Clock 
Comparator instruction is less than the current value in 
the TOD clock, the value is loaded in the clock 
comparator and a send count is issued immediately after 
the Set Clock Comparator instruction. 





INTERVAL TIMERS 


Two interval timers provide the means for measuring 
elapsed time and determining when a prespecified 
amount of time has elapsed. The first interval timer is 
known as the task interval timer and is used by the 
processor for task timing. (See Task Dispatcher 
Enable /Disable Functions in Chapter 5.) The second 
interval timer is for general use. 


Each interval timer is a binary counter with a format that 
is the same as that of the time-of-day clock and is 
decremented by subtracting 1 from bit position 41 every 
1024 microseconds. Both interval timers and the 
time-of-day clock are stepped at the same rate. 


The mechanism used to indicate that an interval timer 
has been decremented from a positive number (including 
zero) to a negative number is different for each interval 
timer. For the task interval timer, an exception is 
recognized. For the second interval timer, an SRC 
(send/receive counter) identified in the control address 
table (see Figure 2-2) is the target for a SENDC 
operation. 


The interval timers can be inspected by means of the 
Store Interval Timer instruction and can be set to a 
specific value by means of the Set Interval Timer 
instruction. When the second interval timer is specified, 
the Set Interval Timer instruction indicates whether the 
time interval is to be repetitive. A repetitive time interval 
can be specified such that the value in the interval timer 
is reset to the value contained in the repetitive interval 
timer doubleword when the prior interval is decremented 
through zero. See Figure 2-2 for the location of the 
repetitive interval timer doubleword. 


This doubleword must begin on a doubleword boundary, 
and be resident in storage or a machine check will occur 
when it is used. The repetitive interval timer doubleword 
must be Set prior to issuing a Set Interval Timer 
instruction or a previous value can be used if repetitive 
timing is specified. 


If an untimed task issues a Set Interval Timer instruction 
to the task interval timer, a specification exception is 
presented. A Store Interval Timer instruction issued by 
an untimed task to the task interval timer stores 
unpredictable results. 


Programming Note: After the indication has been given 
that an interval timer has been decremented through 
zero, the interval timer continues to decrement. Thus, a 
Store Interval Timer instruction can store a negative 
number, becausé the interval timer format is the same 
as an unsigned binary doubleword, which is represented 
as a large positive number. 
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System Control 


The system console and the operator/service panel 
provide external control or alteration of the processor. 


The system console: 
e« Displays requested machine status 


¢ Provides operator-to-machine (or service 
personnel-to-machine) communication 


e Provides controls required by the operator (or service 
personnel) to intervene in normal programmed 
operation 


The operator/service panel and the SCA (system control 
adapter) provide: 


e Means for the control and indication of power 
e« System status lights 


e Qperator control, such as, 
— IMPL (initial microprogram load) 
— Alternative IMPL 
— CPU Start 
— CPU Stop 


Controls power to devices such as the printer for 
concurrent maintenance 


Some controls are for the use of service personnel only. 
The SCA has a direct interface to the processor. This 
interface is described in the System Control Adapter 
Theory-Maintenance manual. 


The SCA functions as follows: 


e When possible, it presents menus to service 
personnel on the system console. 


¢ It accepts responses from the operator/service panel 
or keyboard. 


e It uses the queue structure that is part of the 
processor. 
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The SCA diagnoses system problems. The 
operator/service panel and the SCA assist in 
maintaining the dedicated portion of the system. 


The diagnostic task, using routines written into and 
executed by the SCA, enables concurrent maintenance 
to be performed on a portion of the system. 


SYSTEM CONTROL ADAPTER 


The system control queue is the operational unit queue 
of the SCA (system control adapter). OU (operational. 

unit) number 1 is the value of the OU field of an ORE 

(operation request element) that selects the SCA. The 

command field for the SCA is as follows: 


Command 

Field 

(Hex) Description 

01 Write data-RAM2 

02 Read data-RAM2 

04. Reset SCA 

Oc Start up 

12 Read rotary switches 

19 Write l|OC LSR/data store 
1C Diagnostic write 

21 Write control-RAM1 

2A Read |OC LSR/data store 
2C Diagnostic head 

34 Execute-RAM1 

44 Terminate routine 


The diagnostic task provides functions for system 
maintenance using routines that are written into and 
executed by the SCA. Some of the functions are: 

« Timing tests 

e Power down of individual devices 


e« Test patterns 


e Instruction test/address stop 


J 





Machine Check 


The machine-check function provides a mechanism for 
handling detected machine malfunctions that can occur 
in hardware or HMC. A description of the malfunctions 
handled by the machine check function are given under 
Machine Check Logout later in this chapter. A machine 
check is reported as either a soft machine check report 
(error corrected) or a hard machine check report (error 
not corrected). 


Soft and hard machine checks (called IMP machine 
checks) are reported to the IMP by the PMCH 
(processor machine check handler). The status data for 
machine checks are logged into the MCLB (machine 
check log buffer) by the PMCH. See Machine Check Log 
Buffer for the description of the format and contents of 
the MCLB. The address of the MCLB as specified in the 
control address table (see Figure 2-2) must be fullword 
aligned. If not properly aligned, a second machine check 
will cause the processor to enter check stop mode. 


Once the machine check has been reported by the 
PMCH, the data in the MCLB is used to determine the 
response. After this response has been taken, the 
MCLB is cleared to zeros and the machine check mode 
is reset, thereby clearing the status of the MCLB. 


MACHINE CHECK HANDLING 
Machine checks are reported to IMP whenever: 


« A malfunction is detected below the IMP instruction 
set. 


e An exception condition occurs and the task 
dispatcher is disabled. See Chapter 5. 


« A Terminate Immediately instruction is issued and the 
machine is not in machine check mode. See Chapter 
10. 


e An error exists for some VMC objects that are 
referenced by an IMP instruction (for example, when 
the TDE [task dispatching element] or TDQ [task 
dispatching queue] are not aligned to a fullword). 
See Chapters 5 and 6. 


e Any of the following instructions are executed when 
the task dispatcher is disabled. See Chapters 5 and 
6. 


Receive Message 

Receive Count 

Dispatch Task Dispatching Queue 
— Supervisor Linkage: 

Implicit SVL 

Explicit SVL 

Exception SVL 


Check Stop 


In some situations, it is either impossible or undesirable 
to continue processor operation when a machine check 
occurs. When these situations arise, the processor 
stops all processing and goes to the check stop state. 
See Chapter 4 for the definition of processor states. 


In the check stop state, the processor executes no 
instructions, the interval timers and TOD clock are not 
updated, and channel operations are suspended. 


Check Stop Initiated by HMC 


There are two sources for a check stop by HMC. The 
first is a machine error occurring while an instruction is 
being retried by the HMC because of an earlier error. 
The second is a hard machine error that cannot be 
reported because the MCLB (area in storage where 
machine checks are logged by the PMCH) contains a 
machine check report from a previous error. In each 
case, the check stop is caused by machine errors 
occurring faster than they can be processed. In these 
situations, all processor operations stop (including 
microprocessor, virtual address translator, and channel), 
the SCA (system control adapter) is informed, and the 
SCA displays the state of the processor on the machine 
CE/Op panel sequence indicators. IMPL (initial 
microprogram load) is required to remove the system 
from the check stop state. 


Check Stop Initiated by IMP 


An IMP procedure can put the processor into the check 
stop state, when an IMP procedure has determined that 
error conditions exist such that the IMP processing is no 
longer feasible or desirable. In this instance, the 
Terminate Immediately instruction is issued by an IMP 
procedure (see Chapter 10). 
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Machine Check Mode 


The processor enters the machine check mode 
whenever a machine malfunction or an IMP machine 
check is detected. In this mode, the IMP execution 
characteristics of the processor are altered such that an 
IMP procedure can be activated without the presence of 
a tasking structure (current TDE). Rather than 
performing a task dispatching or SVL (supervisor 
linkage) function to activate an IMP procedure, the 
machine check function branches to a routine whose 
addressability is at offset hex 40 in the control address 
table (see Figure 2-2). The following text (Processor 
Machine Check Handler) defines the interface used to 
pass control to the IMP procedure when the processor 
is in machine check mode. Machine check mode causes 
an implicit disabling of the task dispatcher before control 
is passed to an IMP procedure. The restrictions on the 
machine when the task dispatcher is disabled are 
defined in Chapter 5. If the restrictions are violated by 
an IMP procedure, a second machine check occurs, 
causing the processor machine check function to put the 
machine into the check stop state. It is the 
responsibility of the activated IMP procedure to enable 
the task dispatcher, if desired. The reenabling of the 
task dispatcher can be performed via the Enable Task 
Dispatching instruction (reference Chapter 10). 


It is also the responsibility of the activated IMP 
procedure to reset the machine check mode if desired. 
This function can be performed via the Reset Machine 
Check Mode instruction (reference Chapter 10). 


PROCESSOR MACHINE CHECK HANDLER 


The PMCH (processor machine check handler) is a 
processor HMC routine (built-in function) that: 


¢« Retries hardware-signaled errors 

« Loads the MCLB (machine check log buffer) with 
machine check status information (see Machine Check 
Log Buffer, later in this chapter) 


e« Disables task dispatching 


« Branches to the IMP procedure whose address is at 
offset hex 40 in the control address table 


e Initiates the termination of processing for some error 
conditions 
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When the processor encounters a hardware malfunction, 
it pauses from 1 to 2 milliseconds before trapping to the J 
PMCH. This pause allows any intermittent electrical 

noise to subside. During this time, the processor 

hardware determines if the PMCH is being executed at 

the time of the machine error; if so, the processor 

enters the check stop state. 


When a processor error occurs, the PMCH determines if 
the error can be retried. A retryable error is an error that 
occurs in an IMP instruction before source data has 
been changed, or an error that occurred in an IMP 
instruction that can be executed again without changing 
the final results. 


If the instruction is successfully retried, the PMCH is 
activated again to report successful recovery of a 
machine error. This is a soft machine check report. If 
the machine is in machine check mode, the soft 
machine check is not reported and the next sequential 
IMP instruction is executed. If the machine is not in 
machine check mode, the PMCH loads the error 
information into the MCLB whose addressability is at 
offset hex 38 in the control address table (reference 
Figure 2-2). The task dispatcher is disabled and an exit 
is made to the IMP procedure whose addressability is at 
offset hex 40 in the control address table. J 


If the instruction retry is unsuccessful or impossible, and 
the PMCH determines that the machine is not in 
machine check mode, the PMCH moves the machine 
check error status information into the MCLB. The task 
dispatcher is disabled and control is passed to the IMP 
procedure whose addressability is at offset hex 40 in the 
control address table. If the machine is in machine 
check mode, the PMCH puts the processor in the check 
stop state. At this time, the MCLB contains the earliest 
hard machine check processor status and the earliest 
soft or hard machine check task status. 


Before the PMCH passes control to the IMP procedure, 
the PMCH: 


e Puts the machine in machine check mode 

¢ Fills the log buffer with the following machine check 
information: 
— Processor status 


— Task status 


« Disables the task dispatcher 


« Stops the task interval timer 3 


Machine Check Process Procedures and States 


Following is a diagram of the processor machine check 
procedure and the various states that the machine can 
be put in by the PMCH. 


Machine Check Occurs 





Not Retryable Stop State Retryable 
Machine Normal Check 
Check Mode! Stop 
Mode 
Check Hard Machine Check Retry 
Stop (reported to VMC) 
Not Successful Successful 
Machine Normal Machine Normal 
Check Mode! Check Mode! 
Mode Mode 
Check Hard Machine Check Next Soft Machine Check 
Stop (reported to VMC) Sequential (reported to VMC) 
Instruction 


‘Normal mode includes the run and wait states when the processor is not already handling a 


previous machine check. 
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Stop State Machine Check 


If a machine check occurs when the processor is in the 
stop state, the processor enters the check stop state. 


Wait State Machine Check 


Two phases of processor activity are possible when it is 
in the wait state; it can either be active, servicing |/O 
and timer events, or it can be idle, not servicing |/O or 
timer events. 


If the processor is active and a machine check occurs, 
the processor exits the wait state, logs the processor 
and task status into MCLB and reports a hard machine 
check. 


Programming Note: The IMP machine check handler 
programmers should note that, in this situation, the 
processor is in the operational state with no TDE 
present on the TDQ. 


The processor maintains internal status indicating a hard, 
machine check while in the wait state. This status is 
used by the processor in the following manner when the 
Enable Task Dispatching instruction is executed: 


« If there is no TDE on the TDQ, the processor returns 
to the wait state without storing task status into any 
TDE. 


« If there is a TDE on the TDQ, the processor switches 
in the new task without first storing task status into 
any TDE. 


If the processor is in the wait state and the operation 
being executed is retryable (MCLB byte hex E bit O = 1) 
when a machine check occurs, the PMCH logs the 
processor status and returns to the wait state. The 
PMCH also sets an internal flag called soft log required; 
thus, when the processor is reactivated (from the wait to 
run state), the PMCH will regain control. The PMCH will 
log the currently activated task into the task status and 
report the processor and task status to the IMP machine 
check handler. 


If the processor is in the wait state and the operation 
being executed is not retryable (MCLB byte hex 14 bit 0 
= QO) when a machine check occurs, the PMCH logs the 
processor Status. If the MCLB was not busy the task 
status is also logged. However, if the buffer is already 
busy, no log of the task status occurs. Control is passed 
to the IMP machine check handler to report this 
machine check immediately after logging. The PMCH 
resets the wait state before control is transferred to the 
IMP machine check handler. 


If the processor is in the wait state and the operation 
being executed is retryable but has been unsuccessfully 
retried by the PMCH, the PMCH logs the task status, 
resets the wait state, and transfers control to the IMP 
machine check handler. 


Programming Note: The task status may not be valid or 
consistent with the processor status for wait state 
machine checks. 


Restart Task if Machine Check Is in Run State 


The task status section of the MCLB provides a 
mechanism for restarting the IMP procedure that was 
executing at the time of the machine check, if the 
processor was in the run state. The IMP machine check 
procedure can determine the state of the machine at the 
time of the machine check by referencing byte hex 15 
bit 4 of the MCLB (see Processor Status in this chapter). 
If this flag is set to zero, the processor was in the run 
state when the machine check occurred. In this 
instance, the current TDE that is addressed at offset hex 
48 in the control address table is the task that was 
active at the time of the machine check. If the task is to 
be restarted following a machine check, the task 
information in the MCLB must be moved to a CRE; that 
CRE is marked as the first CRE to get control following 
an SVX instruction. The IMP machine check procedure 
uses the SVX instruction to pass control to the IMP 
procedure that was active at the time of the machine 
check. 


J 





C 


The following illustrates the steps that should be 
performed by the IMP machine check processor to 
restart the IMP procedure that incurred a machine 
check: 





Step 1 
Current TDE MCLB 
TDE 1 z 
: Processor Status 
In-Use | Procedure x Status 
CRE 1 | 
Procedure x | 
In-Use | eee eee eree | 
CRE 2 7 nena a l CRE 
See | 
| 
| 
m—-—--—---— (a machine check occurs) 
mt+1—--— 
n SS eee 


Current TDE 
Procedure x 


Status from TDE 1 
MCLB | | 
CRE 1 


In-Use In-Use 
CRE CRE 


Note: The Enable Task Dispatcher instruction does one 

of two things: 

1. Continues processing without a task switch, thereby 
using processor status associated with the IMP 
machine check handling procedure; or 





CRE 1 






Step 2 


IMP Machine Check Routine 
(addressed in the IMP 
control address table) 


Restart Procedure x 
@ Get an available CRE 
@ Move procedure x status 
in MCLB to CRE 
@ Enqueue CRE to current TDE 
as first CRE 
@ RMCM (reset machine check mode) 
@ Clear MCLB 
@ Enable task dispatcher (see note) 


If the TDE 1 is redispatched, the IMP machine check 
handling is activated to do the SVX. 


——» Procedure x 


(a hard machine check occurs) 


2. Performs a task switch, causing the processor status 
associated with the IMP machine check handling 
procedure to be stored in the dispatcher’s CRE 
section of the TDE 1. See Chapter 10 for the Enable 
Task Dispatcher and Reset Machine Check 
instructions. 
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MACHINE CHECK LOG BUFFER 


Machine check reports are found in the MCLB (machine 
check log buffer) whose addressability is at offset hex 
38 in the control address table (see Figure 2-2). Figure 
9-1 illustrates the format of the MCLB. The MCLB 
information contains the type of error that occurred, an 
indication of whether it was recovered or not, and the 
status of the hardware and processor at time of error 
along with the status of the procedure executing at the 
time of the error. This information is divided into two 
categories of status: processor status and task status. 


Task status contains the status associated with the task 
whose address is in the current TDE location, offset hex 
48 in the control address table. The information in the 
task status of the MCLB is valid only when the 
processor is in the run state. If the processor is in the 
wait state, the processor status associated with the 
current TDE is invalid because it reflects the processor 
status in the wait state at the time of the machine 
check. 


Machine Check Log ) 


When a machine check occurs, the data is logged out to 
the MCLB (machine check log buffer). Depending on the 
prior state of the MCLB, the following condition will be 
logged: 


- Both the processor status and the task status; 

« The task status only; or 

« Neither processor status or task status. 

The format of the MCLB is described in the text that 
follows. 

Processor Status 

The processor status field of the MCLB contains the 
information needed to determine the type and severity 
of the machine check. It also contains information that 


indicates the state of the HMC at the time of the error. 
This field contains 44 bytes. 











MCHK Designati MCHK Designati 
Error Type VMC Flags Spee ee 
(primary) (secondary) 
Main Storage Error Code 
Retry Indicator G-Register Operation Goce 
Extender 
Current 
Operation Code 
" MCLB Status Moonn | 
HMC Flags 
HMC Exceptions Overlay Index A/B 
IMP Exceptions Condition Code 
Lookaside Buffer aie Roni 
Miss Control Address Ee 


Exception Register Overlay Index C/D 


c Base Register Instruction pe ee eee 
CRE Flags Specification Length angreon 088 


Address Register 



















Processor 
Status 


Rese rved 







Instruction 
Length 






Base Register (O—F) 
(16 x 6 = 96 bytes) 


Failing V=V Address 
(all 5382 System Unit models) 


These bytes are reserved for all other models. 


IMP Exceptions 


Figure 9-1. Machine Check Log Buffer 
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Processor Status (continued) 


Bytes 
(Hex) 


0 


Bits 


Bytes 
(Hex) Bits 


6 
Descriptions 


Error Type: 


HMC-detected errors: See HMC 
Flags (bytes 14-17) for more 
information on specific errors. Also 
see Lookaside Buffer-Miss Control 
Address (bytes 20-21) and Link 
Register (bytes 22-23) for additional 
information. 


Channel checks: Secondary channel 

errors. These are main storage or 

VAT (virtual address translator) 

errors reported via the microcode. 

See Hardware Code and Main 7 
Storage Error Code (bytes 4-B) for 

more information. 


Microprocessor hardware-detected 

error: See Hardware Code and Main 
Storage Error Code (bytes 4-B) for 

more information. 


FIB (fill instruction buffer) error: 
Error occurred while trying to fill the 0 
instruction buffer. 


System damage (HMC procedure): 

Machine checks occurred during an 1-7 
operation that cannot be isolated to 

a specific task. See Hardware Code 

(bytes 4-6) for more specific 

information. 


Instruction-processing damage (IMP 
procedure): Errors that can be 
isolated to a particular task. See 
Hardware Code (bytes 4-6) for more 
specific information. 


Descriptions 





Recovery report: If this bit is set 
and the secondary designation (byte 
3 of MCLB) indicates a value of hex 
2A, successful recovery has been 
made from an initial error. This bit 
can also be set as a result of a 
successful recovery report attempted 
due to a second recoverable error 
while handling the initial error. In 
this case, the second error report is 
suppressed with this condition being 
identified by the bit being set and 
the secondary designation (byte 3 of 
MCLB) indicating a value of hex 2B. 
See Hardware Code for additional 
information about the error. 


Timer errors: Error that occurred in 
any element of timing. 


Programming Note: All the timers 
being used (including the TOD) must 
be reinitialized following a timer 
error. 





VMC Flags: 

QO Not VMC machine check. 
1 VMC machine check. 
Reserved: May be any value. 


Note: HMC initializes this byte to 
hex OO. 





C 


Bytes 
(Hex) 


2 


Bits 


Description 


MCHK Designation-Primary: See 
the following diagram for the 
designation number. Each 
designation number uniquely 
identifies the facility which detected 
the machine check, the state of the 
processor, the functions performed 
by the PMCH (processor machine 
check handler), and the exit from the 
PMCH. As an example, if the 
designation number found in the 
MCLB was hex 21, the general 
facility that reported this machine 
check was microcode. If this column 
is followed down to where the first 
X appears, the processor was in the 
run state when the machine check 
occurred. The next X indicates that 
the retry indicator was Q. The next 
X indicates that the MCLB was not 
busy. The next group of Xs indicate 
what should have been logged as 
well as other functions that should 
have been set or reset such DTD = 
QO (disable task dispatcher). Further 
down are the exits from PMCH to 
checkstop, IMP machine check 
handler (startup), or go to wait state. 
In this case the machine check 
would have reported to IMP via 
startup. 


Hex Code 

00-16 Hardware facility 
1B-24 Microcode facility 
26-29 Channel facility 
2A-2B Recovery-Soft 
2C-32 Timer facility 
36-37 Channel facility 
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* Designation I 


No Logout 


IMPL State - 


SCA Transfer in Process - No Logout 


Designation S 


** yndicates MCLP STATUS 


Condition or Response 


x 


No Response 
No Condition or No Response 


N 
blank 
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Machine Support Functions 





FACILITY ——> MICROCODE RECOVERY TIMERS 


ENTRY POINT Saar 





IMPL 
STOP 
WAIT 
RUN (IMPLIED) 


= ee ia ie le 


x wh 
SCA TRANSFER IN PROCESS 
RETRY INDICATOR = 0 
RETRY INDICATOR = 1 
FIB ERROR 





MCLB NOT BUSY 
MCLB BUSY SOFT 
MCLB BUSY HARD 





LOG CRE DATA x 
SET RETRY INDICATOR x 
SET RETRY INDICATOR 





DISABLE TASK DISPATCHER | x 
R |MCLB BUSY = SOFT | 
E |MCLB BUSY = HARD x x 
S |RESET WAIT STATE 
P |SET SOFT LOG REQUIRED x 
O |SET SOFT LOG REQUIRED 
N |RESET AUTO ERROR IN VAT 
Ss 
E |RESET CHAN ERROR IN VAT 
RESET/RESTART EVERYTHING 
SUBTRACT IL FROM IAR (EOC) 
IL = 0 
STOP TASK INTERVAL TIMER x x x 
SET IAR TO IMCH (IL = 0) 
RESERVED 
SET WAIT STATE MCHK FLAG x |x 
UHOO CODE TO SCA x 1X 
{| {CHECKSTOP STATE 
E }RETURN TO SCA OR FIX UP 
x |START UP W/AT (ESRT.ESRTAT) 
I |START UP W/NT (ESRT.ESRTNT) 
T |GO TO STOP STATE (ESP1.ESCAO) 
GO TO WAIT STATE (TWTL. TWTLNE ) 
RETURN TO CALLER 





** indicates MCLB STATUS 


X = Condition or Response 
D = Hard-hard double bit error corrected condition 
will be ORed into processor status 
N = No Response 
blank = No Condition or No Response 
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Bytes 
(Hex) Bits 
3 
4-6 
4 0-7 
5 0 

1 

we 

2 

3 

4 

5 

6 
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Processor Status (continued) 


Bytes 
(Hex) 


Description 6 


MCHK Designations—Secondary: 
Designation number if a second 
MCHK occurred before the first was 
handled or indicates the recovery 
designation number after a recovery 
log has been executed. 


Hardware Code: Specific hardware 
error. Note that byte 6 has meaning 
only when byte 5, bit 1 is a 1; and, 
if byte 6, bit O is a 1. Additional 
information is contained in the Main 
Storage Error Code (bytes hex 7-B). 


Reserved: Must be zero. 


Main storage time-out error (Models 
3, 4, and 5). Reserved: Must be 
zero (5381 Models 6, 7, and 8; all 
5382 models). 


7-B 


VAT (virtual address translator) 
machine check. 7 


ALU (arithmetic logic unit) check. 
Reserved: Must be zero. 


Control storage read data parity 
check. 


ALU output parity check. 


IAR (instruction address register) 
parity check. 


Reserved: Must be zero (all 5382 
models). Invalid control storage 
address (all other models). 


Bits 


—_, 


oo f& W WN 


Description 


Main storage error. 


VAT internal parity or VAT error 
during HMC request (such as no 
traps, invalid register or page, or store 
without set change bit set). 


VAT error during channel request. 


VAT error during automatic operation 
(FIB/TOD/IT) (fill instruction buffer 
time /interval timer). An FIB error is 
detected as VAT hardware machine 
check. TOD/IT error is detected by 
microcode. 


Fetch/Store command when address 
compare was made. 


Reserved: Must be zero. 
Address compare buffer select. 


Main Storage Error Code (Models 
3, 4, and 5): Additional main 
storage error information. 


Read data parity check. 

Main storage address parity check. 
Main storage write data parity check. 
Main storage invalid address. 

Main storage multibit failure. 
Reserved: Must be zero. 


Main storage single bit failure (status 
only—does not cause a machine 
check). 


MSAR (main storage address register) 
specification: 


0 MSAR2. 


1 MSAR1. 
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Processor Status (continued) 


Bytes 
(Hex) 


8 


Bits 


0-6 


0-7 


4-7 


Bytes 
Description (Hex) 
Page identifier. 7-B 


Byte identifier (with byte 9). 


Byte Identifier: The byte identifier 

makes up the low order 9 bits of the 

21-bit real address of the failing 7 
storage address. 


00 1/0 access: 
01 Data access. 
10 Data access. 
11 Instruction stream access. 
O Fetch from main storage. 
1 Store to main storage. 
O V=V. 
1 VER. 
Frame identifier (with byte B). 


Frame Identifier: The frame 
identifier makes up the high-order 
14 bits of the 23-bit real address of 
the failing storage address for non 
V=R addresses. For V=R addresses 
byte hex B, bits 1-7 make up the 
high-order 7 bits of the 23-bit real A 
address, and bytes 8 and 9 make up 
the low-order 16 bits. On Models 3, 
4, and 5, bits 1 and 2 of Byte B are 
zero. 


Bits 


2-7 


Description 


Main Storage Error Code 
(Models 6, 7, and 8): 


Additional main storage error 
information. 


Data parity error—CPU/channel. 
Main storage error. See the ![BM 
System/38 Processing Unit MAP 
Reference, P/N 2550526, for details. 


Reserved: Must be zero. 


MSAR (main storage address 
register) specification: 


0 MSARZ2. 
1 MSAR1. 


Page identifier. 
Word identifier (with byte 9). 
Word identifier. 
Access type: 
00 1/O access. 
01 Data access. 
10 Data access. 
11 Instruction stream access. 
Virtual = Real. 
O Not V=R. 
1 VER. 
Fetch/store from main storage. 
O Fetch. 


1 Store. 


Frame identifier (with byte B). 











Processor Status (continued) 


Bytes Bytes 
(Hex) Bits Description (Hex) Bits 
B 0-7 Frame identifier. 8 0-1 


Note: Bytes 8, 9, A, and B are used 
to form a 24-bit real address as 
follows: If byte A, bit O is set: 


Add- 

ress 

Bits Bytes and Bits Used 2 

0-7 B  O-7 3 

8-15 8 0-7 

16-21 9 0-5 

22, 23 Forced to 00 oe 
If byte A, bit O is reset: y 

Add- 9 0-5 

ress 6-7 

Bits Bytes and Bits Used A 0-7 

0 Forced to 00 B 

1-6 A 0-7 

7-14 B 2-7 

15 8 7 

16-21 9 0-5 

22, 23 Forced to 00 : 

7-B Main Storage Error Code O=e 
(all 5382 Models) 7 
Additional main storage error 
information. 

7 0 Data parity error—-CPU/channel. 


1-4 Main storage error. See the /BM 
System/38 Processing Unit MAP 
Reference P/N 2550526, for details. 


5-7 Reserved: Must be zero. 


Description 


Access type: 

OO I/O access. 

O01 Data access. 

10 Data access. 

11 Instruction stream access. 
Reserved: Must be zero. 
Fetch/store from main storage. 

O Fetch. 

1 Store. 

Failing main storage card number. 
Word identifier (with byte 9). 
Word identifier. 

Reserved: Must be zero. 

Frame identifier (with byte B). 


Frame identifier: The frame identifier 
makes up the high-order 16 bits of 
the 25-bit real address of the failing 
storage address. Bytes 8 and 9 make 
up the next 7 bits. The low-order 2 
bits are forced to zeroes. 


Retry Indicator: 
Reserved: Must be zero. 


Retry indicator: 


0 Successful retry.: (If a retry 
was never attempted, bit 7 
always = 0.) 


1 Unsuccesfui retry. 
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Processor Status (continued) 
Bytes 
(Hex) Bits Description 


D S-Register: Processor hardware 
status register which contains 
temporary HMC status and condition 
code. 

0-3 Temporary HMC flags. 


4 Hardware overflow. 


5 High-order result bit of an indirect 
binary add or subtract. 


6 Carry from the ALU (arithmetic logic 
unit). 
7 ALU result equal to 0. 
E G-Register: Hardware register 


collection of control latches used by 
the processor logic and HMC. 


0 Checkpoint address valid. This bit 
indicates whether the microprogram 
was checkpointed when a machine 
check occurred: 

QO Instruction not retryable. 
1 Instruction retryable. 

1 Temporary HMC flag. 

2 Block machine check trap. If this bit 
is set, a machine check error will not 
trap the microprogram. This bit is 
for diagnostic use only. 

3 Temporary HMC flag. 

4 Local storage partition latch. This bit 
is the high-order address bit for 
direct addressing. 

5 Temporary HMC flag. 

6 L-register couple control. This bit, 
when set, indicates the L-register is 


in the coupled mode. 


7 Stop state indication. 
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Bytes 
(Hex) 


F 


10 


9-22 


Bits 


Bytes 
Description (Hex) Bits 
Extended Operation Code: This 11 
byte contains the second byte of the 
instruction if a machine check 0 
occurred while executing an 
instruction with an extended 1-2 
operation code. The low-order 4 
bits contain the operation code 
extender field. This byte is valid 
only if byte hex 10 is equal to one 
of the following: 


Hex OD 80 
5A 83 
6D 91 
71 AE 
79 BE 
CE 3-7 
See Chapter 2 for a description 
of the extended operation code 
format, and Chapter 10 for the 
extended operation code 
assignments. 


12-13 


Operation Code: This byte 
indicates the type of operation being 
performed: 
14-17 
Note: See Machine Check Special 
Error Conditions in this chapter. 


OO _—- Built in function. 


40 HMC procedure. Any other 
value not equal to OO, 40, 
or FF represents the 
operation code of the IMP 
instruction currently being 
executed. See hex byte F 
for a listof extended 
operation codes. 


Description 

Current MCLB Status: 

Reserved: May be any value. 

Encoded current MCLB status: 
00 Log area not busy. 


01 + Log area busy with soft 
MCHK. 


10 Log area busy with hard 
MCHK. 


11 Not used. 
Reserved: May be any value. 


MCSAR (machine check control 
storage address register): CSAR 
address when a hardware-detected 
failure has occurred (MCLB byte O, 
bit 2=1). MCLB hex bytes 12-13 
will equal O if MCLB hex byte O, bit 

2=0. J 
HMC Flags: Status of various HMC 

and VMC facilities as used by HMC. 

These HMC internal flags are, in 

general, only modified by HMC 

routines directly associated with an 

individual bit or bits. 





C 


Bytes 
(Hex) 


14 


Bits 


0 


1-2 


Description 

Flag virtual address mapped in PD 
(primary directory) when SCA 
(system control adapter) executes 
the Set AC (address compare) for 
VA (virtual address) command: 


O Virtual address mapped in PD. 


1 Virtual address not mapped in 
PD. 


Encoded prior MCHK log busy 
status: 


OO Log not busy. 
01 Log busy with soft MCHK. 
10 Log busy with hard MCHK. 
11 Not used. 
Note: These bits represent the 
status of the log when the MCHK 
occurred. 
Flag interval timer in use: 
O Interval timer not in use. 


1 Interval timer in use. 


Flag TOD (time-of-day clock) in 
use: 


O TOD not in use. 
1 TOD in use. 
Flag clock comparator in use: 
O Clock comparator not in use. 
1 Clock comparator in use. 
Flag task interval timer in use: 
O Task interval timer not in use. 


1 Task interval timer in use. 


Bytes 
(Hex) Bits 


Description 
Flag task switch blocked: 

O Task switch blocked. 

1 Task switch not blocked. 
Flag procedure type executing: 

O IMP procedure. 

1 HMC procedure. 
Reserved: May be any value. 
Flag interval timer repetitive: 

O Not repetitive. 

1 Repetitive. 
Reserved: May be any value. 
Flag processor in wait state: 

O Not in wait state. 

1 In wait state. 
IS (instruction step) mask: 

O Allow IS exception. 

1 Do not allow IS exception. 


SCA (system control adapter) routine 
retryable: 


O Not retryable. 
1 Retryable. 


FIB (fill instruction buffer) window 
flag: 


O Not FIB retry. 


1 FIB retry. 
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Bytes 
(Hex) 


16 


17 


9-24 


Bits 


0-1 


2 


Description 
Reserved: May be any value. 
Soft address compare mode: 


O Not soft address compare 
mode. 


1 Soft address compare mode. 
SCA exceptions: 

O SCA exception. 

1 SCA trap. 
Timer MCHK flag: 

O Not timer error. 

1 MCHK timer error. 
MCHK in wait state. 

O MCHK not in wait state. 

1 MCHK in wait state. 
Task-controlled interrupt allowed. 
SLVM1 instruction enabled. 


Reserved: May be any value. 


Bytes 
(Hex) 


18 


19 


Bits 


Description 7 ) 


HMC Exceptions: 
Flag execute instruction: 
O Not execute instruction. 
1 Execute instruction. 
Flag soft MCHK report pending: 
O No soft MCHK report pending. 
1 Soft MCHK report pending. 
Flag IS (instruction step) mode: 
O Not in IS mode. 
1 In IS mode. 
Reserved: May be any value. 
Microcode Generated Exceptions: 


Flag task dispatcher call required: J 


O No task dispatcher call 
required. 


1 Task dispatcher call required. 


Flag PEM (program event monitor) 
mode: 


O Not in PEM mode. 


1 In PEM mode. 





Bytes 


(Hex) Bits 
19 2-3 
4 
5-7 
1A-1B 
1C-1D 
1E 
0-3 
4-7 
1F 
20-21 
22-23 


Description 
Flag AC (address compare) mode: 

00 Not in AC mode. 

01 In AC sync. 

10 In AC mode. 

11 In data AC mode. 

Event Handler call required: 

O Normal event processing. 

1 Event handler call required. 
Reserved: May be any value. 
Overlay Index A/B: HMC routine 
that was in the control store overlay 
area A and B at the time of the 
machine check. 

IMP Exceptions: IMP exception 
code as described under [MP 
Exception Codes, (under Task Status), 


later in this chapter. 


Condition Code: |MP condition 
code: 


Hex 0. 

Condition code. 

Reserved: May be any value. 
LB-Miss Control Address: 
Lookaside buffer-miss control 


address. 


Link Register: Control storage link 
address at the time of failure. 


Bytes 
(Hex) Bits 


24-25 


26 


27 


28-29 


28 0-7 


29 0 


Description 

Address Register: These 2 bytes 
contain the IAR (instruction address 
register) if an IMP procedure, or the 
left-justified CSAR (control store 
address register) if an HMC 
procedure. 


Reserved: May be any value. 


Instruction Length: IMP instruction 
length. 


Exception Register (Models 3, 4, 
and 5): 


Reserved: Must be zeros. 

|/O channel event: (I/O service 
required). 

|/O channel machine check. 
Main storage address compare. 
Timer carry occurred. 

IMPL (initial microprogram load). 


Reserved: May be any value. 


SCA (system control adapter) 
request pending. 


Microprocessor exception. 
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Bytes 
(Hex) 


28-29 


28 
29 


2A-2B 


9-26 


Bits 


ao Ff W N 


Description 


Exception Register (5381 Models 6, 7, 
and 8; all 5382 Models): 


Reserved: Must be zeros. 


|/O channel event: !/O service 
required. 


|/O secondary error machine 
check—Set by the I/O channel logic to 
indicate that a hard channel error has 
occurred and the |/O channel has been 
stopped until error recovery has been 
completed. 


Main storage address compare. 
Timer carry occurred. 
IMPL (initial microprogram load). 


Main storage double-bit error—Data 
has been corrected in main storage. 


SCA (system control adapter) request 
pending. 


Microprocessor exception. 


Overlay Index C/D: HMC routine 
that was in the control store overlay 
area C and D at the time of the 
machine check. 


Task Status 


The task status field of the MCLB contains information 
that indicates the state of the task that was running at 
the time of the machine check or SCA (system control 
adapter) request. This field contains 110 bytes. 


Bytes 
(Hex) Bits 
2C 
0 
1 
2-7 
2D 
0-3 
4-7 
2E 
2F 


Description 

CRE Flags: This byte contains 

special flags used by the HMC 

logout routine. 

O Valid CRE (call/return element) 
data has not been logged out to 


this area. 


1 Valid CRE data has been logged 
out to this area. 


IMP or HMC task pending: 

O IMP task. 

1 HMC task. 
Reserved: May be any value. 
Base Register Specification: 


Number of the first base register to 
be logged. 


Number of base registers logged 
minus 1. 


Instruction Length: Instruction 
length, right justified. 


Condition Code: IMP condition 
code. 


9 





Bytes 
(Hex) 


30-31 


32-91 


92-97 


98 


Bits 


Description 


Address Register: JAR (instruction 
address register) if an IMP procedure 
or the left justified CSAR (control 
storage address register) if an HMC 
procedure. 


Base Registers: The next 96 bytes 
contain sixteen 6-byte registers 
beginning with the base register 
specified in bits 0-3 of byte hex 2D. 


Failing V=V Address: These 6 bytes 
contain the failing virtual address 
when a page fault results in a 
machine check (all 5382 models). 


Reserved: May be any value (all 
other models). 


IMP Exceptions: Two-byte IMP 
exception code. 


Reserved: May be any value. 
Soft address compare. 


Dispatcher time increment expired 
(task interval timer). 


Monitored ACQ descriptor (SVL 
[ supervisor linkage] receive). 


Monitored CRE descriptor (SVL 
receive). 


Monitored TDE (task dispatching 
element) descriptor (SVL receive 
wait). 


Bytes 
(Hex) 


99 


Bits Description 


00 No exception 

02 Invalid descriptor 

04 Busy 

06 Reserved 

08 Allocate page frame 

OA Monitored SRQ descriptor 
OC Monitored SRM descriptor 
OE Monitored TDE descriptor 
10 SRC overflow 

12 Address translation 

14 PEM (program event monitor) 
16 Execute 

18 Specification 

1A Addressing 

1C Effective address overflow 
1E Data 

20 Binary overflow 

22 Binary zero divide 

24 Decimal overflow 

26 Decimal zero divide 

28 Floating-point overflow 

2A Floating-point underflow 
2C Floating-point inexact result 
2E Floating-point zero divide 
30 Operation 

32 Stack 

34 Verify 

36 Chain Conflict 

38 End of Chain 

3A Edit Digit Count 

3C Length Conformance 

3E Edit Mask Syntax 

40 Invalid Segment Group 

42 Floating-point invalid operand 
44 Reserved 

46 Second Chain Search 

48 Conversion 

4A Invalid floating-point conversion 
4C-74 Reserved 

80 Invalid Segment (note) 

81 Invalid Page (note) 

82 Page Read Error (note) 

83 Invalid Pool State (note) 

84 Invalid Pin Request (note) 
85 Invalid Write Request (note) 
86 Main Store Error (note) 


87-8F Reserved 


Note: Implicit SVL codes. See Chapter 6 for 
the description of all IMP exceptions. 
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MACHINE CHECK SPECIAL ERROR CONDITIONS ) 


Virtual Address Translator Machine Checks 


Since the decode and execution of IMP instructions is 
asynchronous with main storage and the VAT (virtual 
address translator), any MCHK (machine check) 
occurring on a write to main storage cannot be 
conclusively isolated to the instruction which caused the 
MCHK. When this condition is detected, the task which 
incurred the MCHK must be terminated immediately. 
The conditions to test for the above MCHK are: byte 5, 
bit 1 = 1; byte 6, bit O = 1; and byte 7 bit 2 = 1. 


Machine Check During Translate Instruction 


A Translate instruction, due to its special interrupt mode, 
must always force termination of that task if a machine 

check occurs while the Translate instruction is retryable. 
MCLB (machine check log buffer) byte hex 10 = hex CC 
and byte hex OE, bit O = 0 identify this condition. 


Error/Recording Error Definition 


Errors defined for the CPU are described in the J 
Processing Unit Theory-Maintenance manual. 
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Stack Handling 


An IMP stack is a group of storage areas assigned 
sequentially within the addressing space. The stack 
entries provide a means of declaring and using 
save /work areas in storage with nested programs. 
These stack entries are handled last-in, first-out. 


STACK STRUCTURE 


An IMP stack is contained within a segment. A 
software-maintained and used header is found at the 
front of the stack. The stack entries following this 
header are variable in length, double-word aligned, and 
contain an 8-byte area at the front. Two IMP 
instructions (Stack and Unstack) are used to add and 
remove stack entries. 


The size of a stack entry is presented as the contents of 
a halfword register in the Stack instruction. The 8-byte 
area at the beginning of each entry contains 4 halfword 
fields. The first halfword @ is a virtual address offset 
(forward pointer) indicating the start of the next stack 
entry. The second halfword B is a limit for the stack 
presented as an upper address offset boundary. The 
third halfword © is a virtual address offset (backward 
pointer) indicating the start of the previous stack entry. 
The fourth halfword D ] is a flag field in which the only 
IMP-recognized flag is hex bit 15. When set to one, 
this bit indicates that the stack entry is the first entry on 
the stack. An unstack operation is not permitted when 
this flag is set to 1. 
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The following diagram shows a typical stack. When an 
IMP stack operation is performed with address A, 
pointing to the entry currently being used, the entry at 
address A, is formed by computing its end address A, 
filling in its 8-byte area, and updating the stack address 
to A, as the new current entry. When the IMP Unstack 
operation is performed with address A, pointing to the 
entry currently being used (the entry at A, has not been 
created in this case), the stack address is backed up to 
address A, because the flag bit hex 15 is not set to 1. 





IMP Stack 


Storage 
0 2 4 6 Bytes 


Stack Unstack Previous 
1 Entry = x Hex 0001 


Size 1 


Xx Previous ———> A, 


Size 2 
X X Current ——> A, 2 
Size 3 
X x Next A, 
Size 4 





Xx Following —> A, 
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HOLD/FREE FUNCTION 


The IMP hold/free function is embodied in five IMP 
instructions and a storage segment containing chained 
hold records. Each chain represents hold activity for a 
system object and its hash synonyms. In addition, one 
chain contains initialized but as yet unused (in other 
words, available) hold records. 


The hold chains contain ordered HRs (hold records) 
where each record represents an object hold of a 
specified type. A process (or task) can have holds on 
multiple objects and can have multiple holds (of the 
same type or differing types) on the same object. 


Hold Chain Structure 


Figure 9-2 shows the six data fields involved with hold 
and free. Two 6-byte addresses are maintained in the 
processor control address table. One is the address of a 
4096-byte HHT (hold hash table) and the other is the 
address of the first hold record remaining in the 
preinitialized chain of available (free) records. Two 
halfword fields in the current TDE (task dispatching 
element) that are used are a unique TDE ID (task 
dispatching element identifier) and a count of the 
number of hold records currently in use by the task. 


Machine Support Functions 


9-31 


Control Address Table 


0 Bytes 8 Hold 
Hash 
| | Table 
2 


1 
= HHT Address 

2 
L AHR Address 


3 


‘) 
< 
> 
9°) 
wn 


Entries 


Task Dispatching Element 
0 Bytes 8 


| | Available 
forp 


Figure 9-2. Hold/Free Data Fields 


Programming Note: The HHT entry of hexadecimal 0000 
indicates a null HR chain. Therefore, HRO is not used. 
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Hold Record Area 
Bytes 


Oo 
oh 
Oo) 


HRO (not used) 


HR1 


HR2 


HR3 


HR4 


HR5 


HR6 


HR7 


HR8 


HR9 


Not Initialized 


The other two storage areas used by hold and free are 
the HHT and the HR (hold record) area. The HHT is a 
4096-byte storage page which contains 2048 halfword 
entries. When hold/free activity is performed in an 
object, the 6-byte address of that object is hashed, 
forming a 2-byte index as shown below. 


Object Address (6-Byte Virtual Address) 


0 1 Bytes 2 3 4 5 
Mask 0 7 F F 
as 28 oe 
Hash Hold 
Table Index 


This 2-byte index is used as the address of one of the 
2048 HHT entries. The halfword contents of the 
selected entry (if not = O) are then used as a halfword 
index which, when multipled by 16 and concatenated on 
the right of the high-order 28 bits of the address SID 
(segment identifier) obtained from the AHR (available 
hold record) chain address located in the control address 
table, forms the address of the first (most recent) hold 
record granted for this object and its hash synonyms 
(other object addresses which hash to the same 2-byte 
index value). 


The second storage area, which is composed of 16 
consecutive 64 K segments of address space, is a virtual 
addressing segment called the HR (hold record) area. It 
contains all the HRs used in all object chains plus the 
chain of preinitialized HRs available for additional holds. 
It may also contain some uninitialized area for expansion 
of the available hold record chain. The HR area 
segments are identified by the high-order 28 SID bits of 
the AHR chain address contained in the control address 
table. 
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Hold/Free activity involves the use of seven IMP The first six of these instructions have as one operand a 


instructions. These instructions are: base register containing the 6-byte effective address of J 
the object involved. The Grant/Free and SCB 

« SCB Set Chain Busy instructions have another base register operand to 
receive the address of a hold record of interest (GHR 

« RCB Reset Chain Busy and FHR instructions have this register preloaded with a 
HR of interest and update it to a new HR if necessary). 

e GHRF_ Grant Hold Record First The last four instructions have yet another operand 
which is a storage halfword data field called a hold 

e GHR Grant Hold Record request block. This hold request block contains (1) the 
hold types to be checked for and (2) the holds to be 

e FHRF Free Hold Record First granted for hold, or which were granted if freeing as 


shown in Figure 9-3. 
e FHR Free Hold Record 


¢« RAHR_ Return Available Hold Record 


HRB (hold request block) Format 





HRB HRB 
Text Hold 
0 1 2 
Byte Description 
HRBTEST Holds to be tested for ») 
HRBHOLD Holds to be granted or freed 


HR (hold record) Format 


Hold Record Object Address 





0 1 2 Bytes 


Hold Record Hold Record Cumula- 


Primary Secondary tive Hold| Unused 
Chain Chain Field 


8 A Byte C E F 10 





Figure 9-3 (Part 1 of 2). Formats of the Hold Request Block and the Hold Record 
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Bytes 
: (Hex) Bits 
0 
0 
1 
2-4 
5 
ww 
6 
7 
1 
2-7 


C 


Bytes 


Description (Hex) Bits 
Hold Record Flag. 8-9 
Head of secondary chain: 
A-B 
O = O Not the head of a secondary 
chain. 
O = 1 Head of a secondary chain. 
Secondary chain monitored: The C-D 
monitored hold is on a secondary 
chain. This bit is set by the VMC 
exception handler. 
1 =O A request was received to E 
free the object. 
1 = 1 No request was received to 
free the object. 
F 


Unused. 
Hold record busy: 
5=0 Not busy. 
5=1 Busy. 
Hold record end of primary chain: 
6 =O Not end of chain. 
6 = 1 End of chain. 
Hold record monitored: 


7 =O Not monitored. 
7 = 1 Monitored. 


Hold Record Hold: Contains the 
HRBHOLD when a hold is granted, 
indicating the type of hold. 


Hold Record Object Address: 
Contains the 6-byte address of a hold 
object. 


Figure 9-3 (Part 2 of 2). Formats of the Hold Request Block and the Hold Record 


Description 


Hold Record TDE: Contains the TDE 
identifier when the hold is granted. 


Hold Record Chain: Contains a 
halfword index of the next hold record 
in the primary chain for hash 
synonyms. This index is also used as a 
backward pointer on the secondary 
chain. 


Hold Record Secondary Chain: 
Contains a halfword index of the next 
hold record in the chain for this object. 
A zero indicates the end of chain. 


Cumulative Hold Field: Contains the 
OR of all the holds on the hold records 
in the secondary chain (exists only 
when there is a secondary chain). 


Unused. 
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HARDWARE TAGS 


Each word in storage has an associated hardware tag 
bit. Tag bits are used to differentiate between data and 
pointers. There is one pointer tag (logical AND of the 4 
hardware tag bits) associated with each quadword (4 
consecutive words) of storage. If a tag bit is set, a valid 
pointer is located in the quadword corresponding to that 
tag bit. If a tag bit is zero, no pointer is located in that 
quadword. 


A quadword in storage that is quadword-aligned (on an 
address divisible by 16) is considered tagged when all 4 
words in the quadword have their hardware tag bits set. 
The quadword is not tagged when any or all of the 
hardware bits in the quadword are reset. 


There are five IMP instructions that can set the 
hardware tag bits. These are Call Internal, Store and Set 
Tags, Move and Set Tags, Insert Tags, and Move 
Characters and Tags. The Add Space Pointer Offset 
instructions (AHSPOI, AHSPO, and AFSPO) can be used 
to modify tagged pointers without setting the 
corresponding tag bits off. The Load and Verify Tags 
instruction checks the hardware tags but does not alter 
them. All other instructions and other facilities that store 
data in storage cause the associated hardware tag bits 
of the words stored to be reset. Thus, a tagged 
quadword cannot be manipulated by an instruction other 
than the instructions referenced above and still remain 
tagged. 


Storage management must save the tags when it writes 
a page to auxiliary storage and restore them when it 
reads the page into main storage. Storage management 
uses the Extract Tags and Insert Tags instructions to do 
this. 
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VMC Service Aids 


Direct support for servicing the VMC exists in two 
facilities: a task switch trace facility and a 
programmable address compare facility. Each of these 
is described in the following sections. 


TASK SWITCH TRACE FACILITY 


General 


The task switch trace facility provides a trace record for 
each IMP task switch in by the processor. Trace records 
are placed into the trace event buffer in storage as they 
occur. When that buffer is full, a buffer-full condition is 
signaled and an alternate buffer is used. Task switch 
trace activity is controlled by a bit in the TDE (task 
dispatching element) of the task being switched in. 


The trace event buffering operation is controlled by the 
trace control table (described later in this chapter), which 
is a control block addressed by an entry in the 
processor control address table (see Figure 2-2). The 
processor control address table contains: 


¢« Buffer offsets and thresholds. 

« An SRC (send/receive counter) used by the processor 
to signal the program of a buffer-full condition, and a 
control bit used to suppress that buffer-full condition 


signal. 


« A damage indicator which the processor notifies the 
program of a buffer wraparound condition. 


The task switch trace record contains: 

¢ The TDE (task dispatching element) identifier. 

« A time stamp. 

e The binary overflow and Instruction Address Register 
(control storage address register if an HMC 


procedure) values, for the first procedure to be 
executed in the new task only. 


TDE Control Bit 


The TDE bit that controls TDE tracing is bit 2 of hex 
byte OC. If the bit is a one, the trace function is 
performed when the task is switched in. If the bit is 
zero, the function is not performed. 


Trace Control Table Address 


Hex bytes 98-9F of the processor control address table 
contain the address of the trace control table. Hex bytes 
98-99 are reserved, and hex bytes 9A-9F contain the 
6-byte address. The address has use code b (see 
Permanent Storage Assignments in Chapter 2) and the 
table itself must be doubleword aligned, resident in main 
storage, and must not cross a page boundary; 
otherwise, a machine check occurs. 


TRACE CONTROL TABLE 


The trace control table is a 28-byte object which 
contains the entries that control the logging of trace 
records and notification of the program when the trace 
event buffer is full. 
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Format: 





Reserved 


Trace Count 


2 Bytes 4 6 


Primary Buffer 
Offset 


Primary Buffer 


Threshold 


Send/Receive Counter 





A Bytes 
Bytes 
(Hex) Bits 
0 
1 
0 
1 
2-/ 
2-3 
4-5 
6-7 
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Alternate Alternate 
Buffer Buffer 
Threshold Offset 
C E 10 
Description 


Type: Contains the trace control table 
type (hex E3). 


Control: Control. 
O Buffer wraparound has not occurred. 
1 Buffer wraparound has occurred. 


O Disable SENDC on wraparound 
condition. 


1 Enable SENDC on wraparound 
condition. 


Reserved: May be any value. 
Reserved: May be any value 


Trace Count: The number of 4-byte 
blocks currently in the primary trace 
event buffer. 


Primary Buffer Offset: Provides the 
address offset within the trace control 
table segment to the beginning of the 
primary trace event buffer. 


Bytes 
(Hex) Bits 


8-9 


10-1B 


1C 


Description 


Primary Buffer Threshold: The 
number of 4-byte blocks of data that 
can be put into the primary buffer. 


Reserved: May be any value. 


Alternate Buffer Threshold: The 

number of 4-byte blocks of data which 

can be put into the altenate buffer. 

When the primary buffer becomes full, 

alternate buffer threshold is copied to 
the primary buffer threshold by the J 
processor. 


Alternate Buffer Offset: Provides the 
address offset within the trace control 
table segment to the beginning of the 
buffer area which is to be used when 
the primary buffer exceeds its limits. 
When this occurs, the alternate buffer 
offset is copied to the primary buffer 
offset by the processor. 


Send/Receive Counter: The 
send/receive counter in the trace 
control table is used to control the 
dispatching of the task which handles 
buffer-full conditions. 





Task Switch Trace Record 


The task switch trace record is a 16-byte record that 
contains the information to be logged each time a task 
switch occurs. This information includes a time stamp, 
the TDE (task dispatching element) identifier, and the 
Current instruction stream address. 


Format: 


TDE 
Identifier 


Type Length 


Time Stamp 


Address 


Base Register 0 
Register 


8 Bytes A 


Bytes 
(Hex) Bits Description 


0 Type: Contains the task switch 
trace record type (hex FO). 


1 Length: Contains the trace record 
length, expressed in terms of 
number of 4-byte blocks, as well as 
the type of procedure contained in 
the TDE CRE (call/return element). 


0 O IMP procedure. 
1 1 HMC procedure. 
1 Reserved: Must be zero. 


2-5 Length (= binary 0100). 
6-7 Reserved: Must be zeros. 


2-3 TDE Identifier: Contains the ID 
field of the TDE. 
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Bytes 
(Hex) Bits 


4-7 


8-9 


Description 


Time Stamp: Contains bytes 2-5 
of the current time of day clock 
value. If time of day clock is not 
running, it contains all zeros. By 
using bytes 2-5 of the clock, 
approximately 20 hours of unique 
time stamps are available. 


Address Register: If byte 1, bit 
O is zero, this contains the IAR 
(instruction address register) value 
of the TDE CRE; otherwise it 
contains the CSAR (control store 
address register) value of TDE 
CRE. 


Base Register 0: Contains the 


base register zero value of the 
TDE CRE. 
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Operation 7. Length is added to the trace count in storage. ) 


Each time a task switch-in occurs, TDE byte C, bit 2 is 8. The result of step 7 is tested for a value greater 
tested by the processor. If on, a task switch trace than or equal to the primary buffer limit. If not 
record is generated and added to the trace event buffer greater than or equal, the buffer operation is 

in storage, as follows: complete; otherwise the operation continues. 

1. The trace control table is accessed via bytes hex 9. The trace count is loaded with hex OOOO. 
98-9F of the control address table and the trace 
count is multiplied by four to obtain an index to 10. The primary stack offset and alternate buffer 
the current entry of the buffer. offset are compared. If equal, byte 1, bit O of the 

trace control table is set, and the operation 

2. The result of step 1 is added to the primary stack continues. 
offset to obtain the offset of the first byte of the 
new buffer entry. A carry from bit O or a 11. The alternate trace offset and alternate trace limit 
nonfullword-aligned result causes a machine check are copied to the primary trace offset and primary 
to occur. trace limit, respectively. 

3. The offset obtained in step 2 is concatenated with 12. Byte 1, bit 1 of the trace control table is tested. If 
the trace control table SID (segment identifier) and set, a send count operation is performed using 
the resulting virtual address is translated. If the bytes hex 10-1B of the trace control table. 
address cannot be translated, a machine check 
occurs. 

Programming Note: The threshold test ensures that a 

4. A value of 1 is subtracted from 4 times the length trace record does not begin beyond the threshold. 
and this new value is added to the result of step 2 However, it is possible that the end of a record can 
to obtain the offset of the rightmost byte of the extend beyond the threshold. Hence, an overflow area 
new buffer entry. A carry from bit O of the result should be provided at the end of each buffer. The J 
causes a machine check to occur. length of the overflow area should equal the trace 


record length minus 4 bytes. 
5: Step 3 is repeated, using the offset value obtained 


in step 4. 


6. The trace record is written to the address obtained 
in step 4. 
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ADDRESS COMPARE MODE 


The address compare mode allows the program to be 
signaled whenever one or more of the following events 
occur: 


« An instruction is fetched from a designated virtual 
storage location. 


« The contents of a designated virtual storage location 
are accessed by either the processor or the |/O 
channel. 


e The contents of a designated virtual storage location 
are altered by either the processor or the |/O 
channel. 


e« The contents of a designated virtual storage location 
are altered to a predetermined value by either the 
processor or |/O channel. 


An address compare mode is established through the 
use of the Set Address Compare Mode instruction. 
When an address compare match occurs, the program is 
signaled via an address compare exception; when the 
exception occurs, the address compare mode remains 
set and the compare address is unchanged. The 
address compare mode is terminated via the Reset 
Address Compare Mode instruction. 


An address compare mode can be set up to occur for 
an instruction stream fetch, a processor data access, or 
an |/O channel data access, selectively. Also, it can be 
set up to occur if any of the preceding three access 
types occur. Two other setup options are available with 
the address compare mode. The first is the capability to 
snecify that an exception is to be recognized only if a 
store type access to the designated storage location 
occurs during a processor or |/O channel data access, 
as Opposed to the general capability where either a 
fetch or store type access causes an exception to be 
recognized. The second is the capability to compare the 
value of a prespecified character to the character stored 
in the designated storage location by the processor or 
|/O channel; an address compare exception occurs only 
if the two characters compare. 


When an address compare match Is detected for an 
instruction stream fetch, the exception occurs prior to 
execution of the designated instruction. If the instruction 
consists of multiple units of operation, an exception 
occurs prior to execution of each of the units of 
operation. When an address compare match occurs for 
processor data accesses, an exception occurs after 
completion of the unit of operation during which it 
occurred, where the unit of operation can be either an 
IMP or HMC unit of operation. |If the processor is not 
executing a unit of operation when the address compare 
occurs, the exception is recognized after completion of 
the next unit of operation to be executed. For example, 
if the processor is in the wait state and an address 
compare occurs due to servicing of the IMP timers, the 
exception is not recognized until a task switch occurs. 
When an address compare match is detected for an |/O 
channel access, an exception is recognized after 
completion of the unit of operation currently being 
executed by the processor. if none is being executed, 
the exception is recognized as in the case above. 


The address compare exception is maskable if it occurs 
on the instruction stream. If bit 9 of the TDE (task 
dispatching element) exception mask field is 0, it is set 
to 1 by the processor, but no exception occurs and the 
instruction is completed normally. The mask allows the 
IMP exception handler to leave an address compare set 
at a particular instruction after the address compare has 
initially occurred. Without the mask, it would be 
necessary for the program to remove the address 
compare in order to avoid an endless loop. 
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The following is the processing sequence for an 
instruction address compare, set by the Set Address 
Compare Mode Instruction: 


de Address compare mode is set for an instruction 
fetch at storage location L. 


2. Bit 9 of the TDE (task dispatching element} 
exception mask field is set to 1, allowing normal 
operation of instruction-fetch address compare 
exceptions. 


3. An address compare exception occurs when the 
instruction is fetched from storage location L. The 
instruction has not yet executed. 


4. The IMP exception handler responds to the 
exception by setting bit 9 of the TDE exception 
mask to Q. The instruction at storage location L is 
retried. 


5. No exception occurs and the instruction completes 
normally. The processor sets bit 9 of the TDE 
exception mask to 1, enabling the address 
compare exception to be presented the next time 
the instruction at storage location L is fetched. 
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with other exception types, typically PEM (program 
event monitor) and certain other program exceptions 
that are detected after the instruction has accessed an 
operand in storage. A PEM exception and instruction 
stream address compare can be detected simultaneously 
and, if they are, they will be reported in the same CRE 
(call/return element}. Also, many of the other program 
exception types can be detected simultaneously with a 
processor or |/O data exception, in which case both will 
be reported in the same CRE. 


The address compare exception can occur concurrently ) 


The processor address compare facility handles both 
V=R and V=V addresses. If the compare address is a 
V=R address, it is converted to a real address format 
and loaded into the address compare facility. If the 
compare address is a V=V address, an attempt is made 
to translate it to a real address. If the translation is 
successful, the real address is loaded into the address 
compare facility. If the translation is not successful, the 
virtual address is buffered in the processor. Then, 
whenever a new address is loaded into the lookaside 
buffer or resolved for |/O use, the buffered virtual 
address and address being resolved are compared. If 
the segment identifier and page identifier portion of the 
addresses compare, the buffered virtual address is 
converted to a real address and loaded into the address ’ 
compare facility. Conversely, when the Invalidate J 
Primary Directory Entry instruction (or Examine Primary 
Directory Entry instruction, under certain conditions) is 
executed, a test is made to determine if the page being 
invalidated in the primary directory contains the address 
in the address compare facility; if it does, address 
compare mode remains set and the buffered virtual 
address is retained but the address compare facility is 
purged. 





Next Command 


SACM 
Operation 


Reset Command from 
Console 


Set Command 
from Console 


RACM 


Current Mode Operation 


Reset Set Reset AC mode| Set console AC Reset AC mode 
programmed 


AC mode 


Set, from program Cancel old, set | Reset AC mode| Cancel old, set Reset AC mode 
new 








Not set Not reset Cancel old, set 
condition code | condition code | new 


Set, from console 





Programming Notes: 


1. 


The processor has an address compare facility which 
is capable of handling a single AC (address compare) 
at a time. This facility is used by both the 
programmed and console-set address compare 
features and when contention occurs, the console-set 
mode receives priority, as shown in the following 
table. The instruction length value stored in the CRE 
(call/return element) when an address compare 
exception occurs is zero. 


Reset AC mode 


4. Normally, the |/O device which causes an address 


compare match continues to transfer data. However, 
there is a System/38 control facility available to the 
customer engineer which, when set, causes the 
device to halt its data transfer after the match occurs. 
Hence, completion of the data transfer cannot be 
guaranteed under all conditions. 


5. If an address compare match is detected when the 


task dispatcher is blocked, the exception is not 
recognized, the match is reset (bit 9 of the TDE [task 


2. The processor and |/O address compare exceptions dispatching element] exception mask is set), and 
are recognized whenever the fullword containing the processing continues; the match is ignored. 
designated byte is accessed. 6. Performance is reduced when an address compare 

3. The character compare operation which occurs as the mode is set and the address compare facility is 


result of the store with compare option of the Set 
Address Compare Mode instruction is performed at 
the end of the unit of operation during which the 
storage access was detected. This means that if 
more than one store to the designated address 
occurs within a single unit of operation, the compare 
is made using the last character stored. Also, since 
the processor detects only fullword accesses, it is 
possible that the compare may occur when in fact 
only bytes adjacent to the tested character were 
modified. 


loaded. 

. For all programmable address compare exceptions, 
the instruction length is set to zero in the CRE (call 
return element). 
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FUNCTION CALL LINKAGE ) 


Function call support is provided to enable the direct 
calling of one VMC function by another, and to provide 
status retention of the calling function without the use 
of the SVL (Supervisor linkage) facility. The function call 
Support provides a means for indexing into a FRAT 
(function routine address table) to obtain routing 
information for the called function. It also provides a 
mechanism by which the status of the calling function 
can be saved, through the use of the IMP stack support. 
The FNC2 (Function Call Double) instruction assumes 
that base register 3 points to the next available stack 
entry. Figure 9-4 represents an overview of the function 
call flow. 


Function Routine Address Table 


The FRAT consists of 256 10-byte entries, and is 
located in virtual storage. The 6-byte address of the 
FRAT is maintained in the control address table entry 
which starts at byte AO. The format of each entry is as 
follows: 


Entry ) 
Address NOU? 


0 2 Bytes 8 A 





Bytes 0-1 Entry address of the first instruction to be 
executed in the function 


Bytes 2-7 Instruction base register value for the 
function being called 


Bytes 8-9 Not used 


Note: If the function routine address table is not 
halfword aligned when accessed by the processor, a 
specification exception is recognized and the operation 
is suppressed. 





C 


Function Call Stack Usage 


The function call facility uses a stack entry to save the 
status of the calling function as follows: 


Stack Entry 


(Hex Byte) Usage 

O-1 Forward stack pointer 

2-17 Not used 

18-23 Base registers 1-2 save area 
24-77 Not used 

78-79 Instruction address register 
7TA-7F Base register O save area 


Function Routine Address Table (FRAT) 











VMC Function 


Entry F 
Address B (0) ot Used 
| 


Leeper ee nt 


Called Entry Point 





Save 
Area 


B (3) 


Figure 9-4. Function Call Flow 
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Space Pointer Support 





A space pointer is a System/38 object which provides 
addressability to a specific byte in the data area 
associated with that object. The following instructions 
assist the VMC in the processing and validation of 
Space pointers: 

e« Add Fullword Space Pointer Offset 

« Add Halfword Space Pointer Offset 

« Add Halfword Space Pointer Offset |!mmediate 

« Compute Address Long 

¢ Compute Address Long Halfword 

e Compare Logical Address Register 

« Load Space Offset Pointer 

« Store Space Offset Pointer 

The following discussion defines the space pointer and 
segment group header fields referenced or manipulated 
by the above listed instructions. 


Space Pointer Fields 


The format of a space pointer is as follows: 


Type Unused 


0 1 Bytes 


SID Segment Group Segment Group 


Extender Identifier Offset 
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Byte 


1-7 


8-9 


Bits 


3-7 


Description 

Type. 

00 System pointer. 
01 Instruction pointer. 
10 Space pointer. 
11 Data pointer. 


O The pointer is resolved (contains a 
valid address). 


1 The pointer is not resolved. 
Reserved: Must be zeros. 
Not used. 


SID Extender: These bytes are 
specified as a 2-byte logical extension 
to the segment group identifier and are 
used and assigned by VMC storage 
management. 


Segment Group Identifier: Used to 
identify a 16 megabyte address space. 
The 3-byte segment group identifier is 
the high-order 3 bytes of an IMP 
6-byte virtual address. 


Segment Group Offset: Used to 
address a byte within a 16-megabyte 
segment group. The 3-byte segment 
group offset is the low-order 3 bytes 
of a 6-byte virtual address. The 
segment group offset is always greater 
than or equal to the space locator 
offset found in the segment group 
header identified by the segment group 
identifier field. 
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Segment Group Header 





The first 32 bytes of the 16-megabyte segment group 
allocated by VMC form the segment group header. The 
segment group header fields that can be referenced 
implicitly via the IMP instruction set are formatted as 


follows: 
SID 
Unused Unused Space Locator Offset 
Extender 
6 


0 Bytes 4 1D 20 





Byte Description 
0-3 Not used. 


4-5 SID Extender: Used as a 2-byte logical 
extension of the segment group identifier 
(bytes A-C of the space pointer), used and 
assigned by VMC storage management. 


6-1C Not used. 





1D-1F Space Locator Offset: These bytes specify 
a 3-byte offset into the segment group and 
identify the lowest available byte in the 
segment group. 


Note: The segment group offset is greater than or 
equal to the space locator offset found in the segment 
group header identified by the segment group identifier 
field. 





The instructions are described in alphabetical order (by 
instruction name) with an example adjacent to each 
instruction. Appendix C is an alphabetical list of the 
instructions by mnemonic; Appendix B is a chart of 
operation code assignments showing the mnemonics 
and operation codes. 


Refer to Chapter 2 for more detailed information about 
instruction formats and registers. 


Some VMC instructions are treated as implicit SVLs 
(supervisor linkage). (These instructions are identified in 
Appendix B.) Whenever an attempt is made to execute 
one of these instructions, the processor causes an 
implicit SVL operation to be performed. The operation 
code of the instruction is used as the index into the SVL 
table. The SVL routine located through the SVL table 
performs the instruction execution. For a detailed 
description of the SVL operation, see Chapter 6. 


Notes: 

1. The result of an instruction is placed in the first 
operand unless stated otherwise within the 
description of the instruction. 

2. The L, L,, and L, fields in the instructions specify a 
value that is one less than the actual number of bytes 
for each operand. 


Chapter 10. Instruction Descriptions 


Data not critical to the execution of an instruction is 
indicated in the instruction format diagram as a blank 
field; the same field is represented in the example 
format diagram with a placeholder value of 0. 
Nonessential data is indicated in the storage example 
with one lower case x per half-byte. Other data used in 
the examples is assumed for the purpose of explanation. 


The examples will be better understood by looking at 
them while reading the instruction description and 
operation. Sequence numbers (for example, El) have 
been used in some of the more complicated instructions. 
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ADD CHARACTERS (AC) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand location. 


Format: SS 





O Bit 8 12 16 20 32 36 47 


Operation: The addition is performed with both 
operands treated as signed binary quantities. If the 
operands are unequal in length, the shorter operand is 
considered to be extended to the left with bits equal to 
the sign bit. 


Overflow: lf the carry from the sign-bit position and the 
carry from the leftmost numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. If 
the first operand is too short to contain all significant 
bits of the result, an overflow occurs and significant bits 
are lost. 


Sign Code: The sign bit of the sum is not changed after 
the overflow. The sign of the sum is unpredictable 
when significant bits are lost. 


Condition Code: If significant bits are lost the condition 
code indicates the sign the sum would have if an 
overflow had not occurred. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
3 rs 


Carry: See Overflow. 
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Boundary Requirements: The operands can overlap in 
storage if the rightmost byte of the first operand is 
coincident with or to the right of the rightmost byte of 
the second operand; otherwise the overlap is destructive 
and the results are unpredictable. 





3 


Program Exceptions: 


Address translation 
Addressing 

— Binary overflow 

Effective address overflow 





AC Example 
Op |L,| L, |B, D, B, D, 
CO 5| 4] 3 040 3 152 
O Bits 8 12 16 20 32 36 47 


Assembler: AC D, (Li, B,), D-,(L2, B>) 
Machine: C054 3040 3152 


B,(3) and B,(3): 0001 4120 0000 


E | 
Storage — Before wa 


0/8 2/A 
0001 4120 0040 0000 Abd42 
0001 4120 0152 2901 





Storage — After 
0/8 2/A 


0001 4120 0040 0029 A653 
0001 4120 0152 2901 





Before After 


Condition Code: x 2 





This page is intentionally left blank. 
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ADD FULLWORD SPACE POINTER OFFSET 
(AFSPQ) 


Instruction Description 


The space pointer specified by the second operand is 
verified as a tagged pointer; the third operard is used 
as a signed displacement which is added to the 3-byte 
offset portion of the second-operand space pointer. 
The 6-byte address that results is loaded onto the 
first-operand register and the second operand space 
pointer, leaving the pointer tagged. 


Format: SS 


joe jej2le) o Jef o 
8 12 


0 Bits 16 20 32 36 47 


Operation: The following validity checks are performed 
on the second operand: 


e The second operand must be tagged. 

e Bits O-2 must be binary 100 (a space pointer). 

e Bytes 8 and 9 of the second operand must match ihe 
halfword in storage (segment group header SID 
extender field) located at the address determined by 
concatenating hex O00 0004 to the right of bytes 10, 


11, and 12 of the second operand. 


If any of these validity checks fails, a verify exception is 
recognized, and the operation is suppressed. 
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The address computation is carried out as follows: the 
segment group offset portion of the space pointer (bytes 
13, 14, and 15) is logically padded on the left with a 
byte of zeros, creating a positive 4-byte signed binary 
integer. This value is then added to the displacement 
identified by the third operand (a 32-bit signed integer). 
The result of this calculation must satisfy the following 
validity checks: 


« |t must be a positive result. 


« |It must not be less than the value of the space 
locator offset. The space locator offset is a 3-byte 
logical binary field in storage located at the address 
determined by concatenating a hex 00 CO1D to the 
right of the 3-byte segment group identifier specified 
in bytes 10, 11, and 12 of the second cperand. 


« The 4-byte sum must be less than hex OOFF FFFF. 


If any of these validity checks fails, an invalid segment 
group address exception is recognized, and the 
operation is suppressed. Otherwise, the rightmost 3 
bytes of the calculated result are concatenated to the 
right of bytes 10, 11, and 12 of the second operand to 
form the resultant 6-byte address. This resultant 
address is placed into the first operand and into the 
address field of the space pointer (bytes 10-15 of the 
second operand). No storage reference is made to 
check for addressing exceptions, using the resultant 
address. The space pointer remains tagged. 


) 





Overflow: See Operation. 


Sign Code: See Operation. 


Condition Code: Not changed. 


Boundary Requirements: The second operand is a 
quadword and must begin on a quadword boundary; 
otherwise, a specification is recognized and the 
operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Specification 

— Invalid segment group address 
— Verify 


AFSPO Example 


Op |B,| E |B, D, B, 
BE |8|2]|2 020 4 
8 12 


O Bits 16 20 32 36 47 





Assembler: AFSPO B,,D;(B,),D3(B3) 
Machine: BE82 2020 4104 

Before After 
B,(8): xxxx XXXxX XXXX OOA5 2000 1320 
B,(2): O00C1 BOOO 4BCO 00C1 BOOO 4BCO 


B3(4): 00C1 BOOO BC24 00C1 BOOO BC24 


Storage — Before 
0/8 2/A 


00C1 BOOO 4BE0 8000 0000 
0005 O00A5 


00C1 BOOO BD28 0000 0800 





Storage — After 


00C1 BOOO 4BE0 


00C1 BOO0O BD28 
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ADD HALFWORD (AH) 
Instruction Description 
The second operand is added to the first operand and 


the sum is placed in the first-operand register. 


Format: RS 


| |rfole| o, 
12 


O Bits 8 16 20 31 


Operation: Both operands are treated as signed binary 
quantities. 


Overflow: lf the carry from the sign-bit position and the 
carry from the leftmost numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. 


Sign Code: Not changed after the overflow. 


Condition Code: If significant bits are lost, the condition 
code indicates the sign the sum would have if an 
overflow had not occurred. A sum and a negative result 
that overflows yields a positive sign. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
3 ee 


Carry: See Overflow. 
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Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs, and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

— Binary overflow 

Effective address overflow 
Specification 


AH Example 

Op B, D, 

80 2 120 
O Bits 8 12 16 20 31 
Assembler: AH R,, D2(B3} 
Machine: 8000 2120 


B2(2): 0023 5430 0000 


Storage — Before and After 


0023 5430 0120 





Before After 
R ; (QO): 0019 0017 


Condition Code: x 2 








ADD HALFWORD IMMEDIATE (AHI) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand location. 


Format: Sl 
Lo | folel o {| 4 
O Bits 16 20 32 47 


Operation: Both operands are treated as signed binary 
quantities. 


Overflow: If the carry from the sign-bit position and the 
carry from the leftmost numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. 


Sign Code: Not changed after an overflow. 


Condition Code: If an overflow occurs, the condition 
code indicates the sign that the sum would have if an 
overflow had not occurred. A sum and a negative result 
that overflows yields a positive sign. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
3 = 


Carry: See Overflow. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


— Address translation 
Addressing 

Binary overflow 

Effective address overflow 
Specification 


AHI Example 
Op I, 
AO a 0234 
O Bits 16 20 47 


Assembler: AHI D,(B;), I, 
Machine: AOOO 3130 0234 


B, (3): 0001 0036 0000 


Storage — Before 


0001 0036 0130 





Storage — After 


0001 0036 0130 





Before After 


Condition Code: x 2 
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ADD HALFWORD REGISTER (AHR) 
Instruction Description 
The second operand is added to the first operand and 


the sum is placed in the first-operand register. 


Format: RR 


| 20 [rir 


O Bits 8 12 15 


Operation: Both operands are treated as signed binary 
quantities. 


Overfiow: If the carry from the sign-bit position and the 
carry from the leftmost numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. 


Sign Code: Not changed after an overflow. 


Condition Code: If an overflow occurs, the condition 
code indicates the sign that the sum would have if an 
overflow had not occurred. A sum and a negative result 
that overflows yields a positive sign. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
23 eas 
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Carry: See Overflow. 
Boundary Requirements: None. 
Program Exception: Binary overflow. 


AHR Example 

Op 

20 
QO Bits 8 12 15 
Assembler: AHR R,, R2 
Machine: 2056 


Before After 


R,; (5): 0021 OO1E 
R» (6): FFFD FFFD 
Condition Code: x 2 





ADD HALFWORD REGISTER IMMEDIATE (AHRI) 
Instruction Description 
The second operand is added to the first operand and 


the sum is placed in the first-operand register. 


Format: RI 


0 Bit 8 12 16 31 


Operation: Both operands are treated as signed binary 
quantities. 


Overflow: If the carry from the sign-bit position and the 


carry from the leftmost bit position agree, no overflow 
occurs; if they disagree, an overflow occurs. 


Sign Code: Not changed after an overflow. 


Condition Code: If an overflow occurs, the condition 
code indicates the sign the sum would have if an 


overflow had not occurred. A sum and a negative result 


that overflows yields a positive sign. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
3 = 


Carry: See Overflow. 


Boundary Requirements: None. 


Program Exception: Binary overflow. 


AHRI Example 

R, I, 

4 0234 
0 Bits 8 12 #=16 31 
Assembler: AHRIR,, I, 
Machine: 5040 0234 

Before After 

R, (4): 0012 0246 


Condition Code: x 2 
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ADD HALFWORD SPACE POINTER OFFSET 
(AHSPO) 


Instruction Description 


The space pointer specified by the second operand is 
verified as a tagged pointer; the third operand is used 
as a signed displacement which is added to the 3-byte 
offset portion of the second-operand space pointer. 
The 6-byte address that results is loaded into the 
first-operand register and the second-operand space 
pointer, leaving the pointer tagged. 


Format: SS 


fee jejrje) o Jel 
8 


0 Bits 12 16 20 32 36 47 


Operation: The following validity checks are performed 
on the second operand: 


e The second operand must be tagged. 

e Bits 0-2 must be binary 100 (a space pointer). 

« Bytes 8 and 9 of the second operand must match the 
halfword in storage (segment group header SID 
extender field) located at the address determined by 
concatenating hex O00 0004 to the right of bytes 10, 


11, and 12 of the second operand. 


If any of these validity checks fails, a verify exception is 
recognized, and the operation is suppressed. 
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The address computation is carried out as follows: the ) 
segment group offset portion of the space pointer (bytes J 
13, 14, and 15) is logically padded on the left with a 

byte of zeros, creating a positive 4-byte signed binary 

integer. This value is then added to the displacement 

identified by the third operand (a 16-bit signed integer). 

The address arithmetic is performed by propagating the 

sign bit through the third and fourth (left) offset bytes 

and performing the 4-byte signed binary addition. The 

result of this calculation must satisfy the following 

validity checks: 


e It must be a positive result. 


« It must not be less than the value of the space 
locator offset. The space locator offset is a 3-byte 
logical binary field in storage located at the address 
determined by concatenating a hex 00 001D to the 
right of the 3-byte segment group identifier specified 
in bytes 10, 11, and 12 of the second operand. 


e The 4-byte sum must be less than hex OOFF FFFF. 


If any of these validity checks fails, an invalid segment 

group address exception is recognized, and the 

operation is suppressed. Otherwise, the rightmost 3 

bytes of the calculated result are concatenated to the | 
right of bytes 10, 11, and 12 of the second operand to Zo 
form the resultant 6-byte address. This resultant 

address is placed into the first operand and into the 

address field of the space pointer (bytes 10-15 of the 

second operand). No storage reference is made to 

check for addressing exceptions, using the resulant 

address. The space pointer remains tagged. 





Overflow: See Operation. 


Sign Code: See Operation. 


Condition Code: Not changed. 


Boundary Requirements: The second operand is a 
quadword and must begin on a quadword boundary; 
otherwise, a specification is recognized and the 
operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Invalid segment group address 
— Specification 

— Verify 


AHSPO Example 





O Bits 8 12 16 20 32 36 47 


Assembler: AHSPO B, ,D2(B2),D3(B3) 
Machine: BE81 2020 4104 

Before After 
B, (8): xxxx xxxx XXXX OOA5 2000 1320 
B,(2): O00C1 BOOO 4BCO 00C1 BOOO 4BCO 


B3(4): O0C1 BOOO BC24 00C1 BOOO BC24 


Storage — Before 
0/8 2/A 


00C1 BOOO 4BE0 8000 0000 
0005 $OQ0A5 


00C1 BOOO BD28 0800 





Storage — After 
0/8 2/A 


00C1 BOOO 4BE0 8000 0000 
0005 OO0A5 
00C1 BOOO BD28 0800 
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ADD HALFWORD SPACE POINTER OFFSET 
IMMEDIATE (AHSPOIl) 


Instruction Description 


The space pointer specified by the second operand is 
verified as a tagged pointer; the third operand is used 
as a signed displacement which is added to the 3-byte 
offset portion of the second-operand space pointer. 
The 6-byte address that results is loaded into the 
first-operand register and the second-operand space 
pointer, leaving the pointer tagged. 


Format: Sl 


[se [efole| vo, | yh 
8 12 


0 Bits 16 20 32 47 


Operation: The following validity checks are performed 
on the second operand: 


e The second operand must be tagged. 

e Bits O-2 must be binary 100 (a space pointer). 

e Bytes 8 and 9 of the second operand must match the 
halfword in storage (segment group header SID 
extender field) located at the address determined by 
concatenating hex 00 0004 to the right of bytes 10, 


11, and 12 of the second operand. 


If any of these validity checks fails, a verify exception is 
recognized and the operation is suppressed. 
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The address computation is carried out as follows: the 
segment group offset portion of the space pointer (bytes 
13, 14, and 15) is logically padded on the left with a 
byte of zeros, creating a positive 4-byte signed binary 
integer. This value is then added to the displacement 
identified by the third operand (a 16-bit signed integer). 
The address arithmetic is performed by propagating the 
sign bit through the third and fourth (left) offset bytes 
and performing the 4-byte signed binary addition. The 
result of this calculation must satisfy the following 
validity checks: 


« It must be a positive result. 


« It must not by less than the value of the space 
locator offset. The space locator offset is a 3-byte 
logical binary field in storage located at the address 
determined by concatenating a hex OO 001D to the 
right of the 3-byte segment group identifier specified 
in bytes 10, 11, and 12 of the second operand. 


« The 4-byte sum must be less than hex OOFF FFFF. 


If any of these validity checks fail, an invalid segment 
group address exception is recognized, and the 
operation is suppressed. Otherwise, the rightmost 3 
bytes of the calculated result are concatenated to the 
right of bytes 10, 12, and 12 of the second operand to 
form the resultant 6-byte address. This resultant 
address is placed into the first operand and into the 
address field of the space pointer (bytes 10-15 of the 
second operand). No storage reference is made to 
check for addressing exceptions, using the resultant 
address. The space pointer remains tagged. 


i 





Overflow: See Operation. 


Sign Code: See Operation. 


Condition Code: Not changed. 


Boundary Requirements: The second operand is a 
quadword and must begin on a quadword boundary; 
otherwise, a specification is recognized and the 
operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Invalid segment group address 
— Specification 

— Verify 


AHSPOI Example 


Op . I, 
BE . a 0800 


0 Bits 16 20 47 
Assembler: AHSPOI B, ,D,(B3),i3 
Machine: BE80 2020 0800 
Before After 
O0A5 2000 1320 


B, (8): xxxx XXXxX XXXX 


B,(2): 00C1 BOOO0 4BCO 00C1 BOOO 4BCO 


Storage — Before 
0/8 2/A 


00C1 BOOO 4BE0 8000 0000 
0005 OQ0A5 





Storage — After 
0/8 2/A 
00C1 BOOO 4BE0 8000 0000 


0005 O0A5 





Instruction Descriptions 10-13 


ADD LOGICAL BYTE (ALB) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: RS 
im tnlite| o 
O Bits 8 12 16 20 31 


Operation: The addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # O, no carry 
2 Sum = O, carry 
3 Sum # O, carry 


Carry: See Condition Code. 


Boundary Requirements: None. 
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Program Exceptions: ' 
> 


— Address translation 
— Addressing 
— Effective address overflow 


ALB Example 


Op |r,| E |B, D, 
amen: al a 00A 
8 31 


O Bits 12 16 20 


Assembler: ALBr,, D2 (B2) 
Machine: 7181 300A 


B2(3): 0012 0001 1000 


Storage — Before and After 


0012 0001 100A 





Before After 
r, (8): 24 B9 


Condition Code: x 1 





ADD LOGICAL BYTE REGISTER (ALBR) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: RR 


0 Bits 8 12 15 


Operation: The addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 


recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # O, no carry 
2 Sum = O, carry 
3 Sum #  O, carry 


Carry: See Condition Code. 
Boundary Requirements and Program Exceptions: None. 


ALBR Example 

Op ir, 

10 2 
0 Bits 8 12 15 
Assembler: ALBRr,, ra 
Machine: 1023 


Before After 


r, (2): 2A C6 
rz (3): 9C 9C 
Condition Code: x 1 
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ADD LOGICAL BYTE REGISTER IMMEDIATE 
(ALBRI) 


Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: Ri 


O Bits 8 12 16 24 31 


Operation: The addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0 Sum = 0, no carry 
1 Sum # 0, no carry 
2 Sum = 0, carry 
3 Sum # 0, carry 
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Carry: See Condition Code. 


2 


Boundary Requirements and Program Exceptions: None. 


ALBRI Example 

r, 

A 
O Bits 8 12 16 24 31 
Assembler: ALBRI 1, I, 
Machine: 43A0 1200 

Before After 

ry (A): CC DE 


Condition Code: x 1 


ADD LOGICAL CHARACTER (ALC) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand location. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The addition treats both operands as 
unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # 0, no carry 
2 Sum = O, carry 
3 Sum # O, carry 


Carry: See Condition Code. 


Boundary Requirements: The operands can overlap if the 
rightmost byte of the first operand is coincident with or 
to the right of the rightmost byte of the second 
operand; otherwise the overlap is destructive and the 
results are unpredictable. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


ALC Example 
Op 
C3 ie ie 
O Bits 16 20 32 36 47 


Assembler: ALC D,(L, B,), D2 (B2) 
Machine: C303 3108 3166 


B, (3): 0010 2250 5000 


Storage — Before 


0/8 2/A 


0010 2250 5108 7683 A591 
0010 2250 5166 
5895 





Storage — After 


0/8 2/A 


0010 2250 5108 ADAC FE26 


0010 2250 5166 


5895 





Before After 


Condition Code: x 1 
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ADD LOGICAL HALFWORD (ALH) Program Exceptions: 


Address translation 2 


Addressing 
Effective address overflow 
Specification 


Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: RS ALH Example 
O Bitt 8 12 16 20 31 90 | 4 

0 Bit 8 12 16 20 31 
Operation: The addition treats both operands as Assembler: ALH R,, D> (B>) 


unsigned binary quantities. 
Machine: 9040 6160 


Overflow and Sign Code: Not applicable. B,(6): 0101 1130 2000 


Storage — Before and After 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0101 1130 2160 





0 Sum = QO, no carry 

1 Sum # QO, no carry 

2 Sum = O, carry 

3 Sum # O, carry om 


Before After 
Carry: See Condition Code. 


R, (4): 1150 29A0 


Boundary Requirements: The storage operand must start Condition Code: x 1 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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ADD LOGICAL HALFWORD AND BRANCH ON 
LIMIT (ALHBL) 


Instruction Description 


The increment of the second operand is added to the 
halfword register specified by the first operand and the 
result is stored in the halfword register specified by the 
first operand. The sum is then compared to the 
comparand of the second operand. If the mask 
specified by the third operand has a corresponding mask 
bit of 1, the IAR (instruction address register) is replaced 
by the sum of the branch displacement of the second 
operand and the offset of the instruction stream base 
address contained in base register 0; otherwise, 
instruction sequencing proceeds with the updated IAR. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The second operand occupies 6 bytes of 
storage. 


Bytes Contain 

1 and 2 Increment value 

3 and 4 Comparand 

5 and 6 Branch displacement 


The increment is added to the first operand and the sum 
is compared logically with the comparand. 

Subsequently, the sum is placed in the first-operand 
location, regardless of whether the branch is taken. 
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The mask field is used as a 4-bit mask generated by 
the compare. The 4 bits of the mask correspond, left to | y) 
right, with the following comparison result: 


Bit Result 

0 Sum = Comparand 
1 Sum < Comparand 
2 Sum > Comparand 
3 es 


Whenever the comparison result has a corresponding 
mask bit of one, the updated instruction address is 
replaced by the sum of the branch displacement and the 
offset portion of the instruction stream base address 
contained in base register 0. If the comparison result 
does not have a corresponding mask bit of one, 
instruction sequencing proceeds with the updated 
instruction address. 


Logical addition is performed by adding all 16 bits of the 
first operand and the increment. 


The 16-bit comparison is also performed with the 
quantities treated as unsigned binary values. 
Overflow and Sign Code: Not applicable. J 


Condition Code: Not changed. 


Carry: If a carry from the high-order bit position occurs 
during the addition, it is ignored and does not affect the 
comparison. 





Boundary Requirements: The second operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


ALHBL Example 


0 Bits 


8 


Op 
OF 
12 


D, 
ABO 
31 


16 20 


Assembler: ALHBL R,, M3, D2 (Bz) 


Machine: 9F44 3AB0O 


B(O): 


Before and After 


0250 AC2C 2E00 


B,(3): OOEF 021E 0000 


OOEF 021E OABO 


R, (4): 


[AR: 


Before 


0022 


3A50 


Storage — Before and After 


0/8 


Updated 


3A54 


2/A 4/C 


O0OOA O002E 003C 





After 


002C 


2E3C 


Instruction Descriptions 
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ADD LOGICAL HALFWORD IMMEDIATE (ALHI) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand location. 


Format: Sl 
O Bits 12 16 20 32 47 


Operation: The addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # O, no carry 
2 Sum = O, carry 
3 Sum # 0, carry 


Carry: See Condition Code. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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Program Exceptions: 





Address translation 
Addressing 

Effective address overflow 
Specification 


ALHI Example 


Op lL. 
BO 1 af 0005 


QO Bits 16 20 47 
Assembler: ALHI D;(B;), Iz 
Machine: BOOO 3170 0005 


B,(3): 0150 1442 6000 


Storage — Before 


0150 1442 6170 





Storage — After 


0150 1442 6170 





Before After 


Condition Code: x 1 





ADD LOGICAL HALFWORD REGISTER (ALHR) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: Fhe addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 


recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # 0, no carry 
2 Sum = 0, carry 
3 Sum #  O, carry 


Carry: See Condition Code. 
Boundary Requirements and Program Exceptions: None. 


ALHR Example 


O Bits 8 12 15 
Assembler: ALHR R,, R2 
Machine: 3056 


Before After 


R, (5): ABCD EEEE 
R, (6): 4321 4321 
Condition Code: x 1 
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ADD LOGICAL HALFWORD REGISTER IMMEDIATE 
(ALHRI) 


Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand register. 


Format: RI 


O Bits 8 12 16 31 


Operation: The addition is performed with both 
operands treated as unsigned binary quantities. 


Overflow and Sign Code: Not applicable. 


Condition Code: A carry from the leftmost bit position is 
recorded in the condition code. 


0 Sum = O, no carry 
1 Sum # 0, no carry 
2 Sum = O, carry 
3 Sum # O, carry 
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Carry: See Condition Code. 
Boundary Requirements and Program Exceptions: None. 


ALHRI Example 

Op 

60 
O Bits 8 12 16 31 
Assembler: ALHRI R;, la 


Machine: 6020 2002 


Before After 
R, (2): 8001 A003 
Condition Code: x 1 








ADD LONG FLOAT (ALF) 
Instruction Description 


The second operand is added to the first operand 
(two-operand format) or the third operand is added to 
the second operand (three-operand format), and the 
sum is placed in the first operand location. 
Interchanging of the two source operands in 
floating-point addition does not affect the value of the 
sum, but can affect which operand is overwritten. 


Format: SS 


sie} oo [el] o, 


0 Bit 8 12 16 20 32 36 47 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used if base 
register O is specified for the third operand. A 
three-operand format is used if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


The exponents of the two operands are compared. The 
significand of the smaller exponent is shifted right as its 
exponent is increased until the exponents are the same. 
The significands are then added algebraically to form an 
intermediate sum. 


The significand of the intermediate sum is rounded, if 
necessary, according to the rounding mode specified in 
the task dispatching element. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
sum. The source operands are checked for this value in 
order of their specification. If two masked 
not-a-numbers are encountered, the masked 
not-a-number with the larger fraction value is used as 
the sum. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the sum is determined by the 
rules of algebra. If the sum of two operands that have 
opposite signs is exactly 0, the sign is made plus for all 
rounding modes except round toward negative infinity, 
where the sign is made minus. 


Condition Code: The result is compared to 0. Values of 
O compare equal even if they differ in sign. 
Not-a-number values and infinite values compare 
unordered with everything else. 


0 Sum =0 
1 Sum < =0 
2 Sum > =0 


3 Sum is unordered 


Carry: \f a carry occurs, the sum is shifted right one 
binary digit position with a high-order 1 bit inserted, 
and the exponent is increased by 1. 


Boundary Requirements: All operands must, be fullword 
aligned - otherwise, a specification exception occurs, and 
the operation is suppressed. 


Operands may overlap only if they are coincidental; 
otherwise, the results are unpredictable. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 
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Programming Note: The following chart shows the 
condition of the sum for various operands. 


‘sm First Source (Addend) Second Source (Addend) 
‘0 


-0 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operation Unmasked not-a-number 
Invalid operation Unmasked not-a-number 
+ 


number # O 


- Infinity +Real number # O or -real | - Infinity 
number # 0 
-Infinity - Infinity +Real number # O or -real 
number # O 


Invalid operation +Infinity or -infinity +|nfinity or -infinity 
woo ft Note 1 
+0 


number # O 


+0 
oft Note 
poo ft 
poo fot ote 2 


Notes: 
1. Value is not rounded toward negative infinity. 





2. Value is rounded toward negative infinity. 
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ALF Example 


Op D, 
CE 060 
O Bits 8 12 16 20 32 36 47 
Assembler: ALF D, (B,), D2 (B), Bs 
Machine: CE31 4050 4060 
B;(3): 0010 0200 0070 


B, (4) and B, (4): 0010 0200 0000 


Storage — Before 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Before After 
Condition Code: x 2 
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ADD PACKED (AP) 
Instruction Description 


The second operand is added to the first operand and 
the sum is placed in the first-operand location. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: Addition is algebraic, taking into account the 
signs and all digits of both operands. All digit codes are 
checked for validity. Improper codes cause a data 
exception to be recognized, and the operation is 
terminated. If necessary, zeros are supplied for the 
leftmost bytes of either operand. 


Overflow: Two possible causes: The first is the loss of 
a carry from the leftmost digit position of the result 
field. The second is an oversized result, which occurs 
when the first-operand field is too short to contain all 
significant digits of the sum, and significant result digits 
are lost. 


Sign Code: The sign of the sum is determined by the 
rules of algebra. When the operation is completed 
without an overflow, a zero sum has a positive sign, but 
when significant result digits are lost because of an 
overflow, a zero sum may be either positive or negative, 
as determined by what the sign of the correct sum 
would have been. 


The processor uses the preferred signs for the sum as 
follows: positive sign is encoded as 1111 (hex F):; a 
negative sign is encoded as 1101 (hex D). All sign 
codes are checked for validity. Improper codes cause a 
data exception and the operation is terminated. 


Condition Code: \If an overflow occurs, the condition 
code indicates the sign the sum would have if an 
overflow had not occurred. 


0 Sum = 0 
1 Sum < 0 
2 Sum > 0 
3 = 
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Carry: See Overflow. 


Boundary Requirements: None. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Decimal overflow 
Effective address overflow 


AP Example 
Op D, 
FO 261 
O Bits 16 20 32 36 47 


Assembler: AP D,(L,, Bi), D2(L2, Bz) 
Machine: FO032 4210 4261 


B, (4) and B, (4): 2793 4766 2000 


Storage — Before 


0/8 2/A 
2793 4766 2210 5718 942D 
2793 4766 2261 24 270F 





Storage — After 


2793 4766 2210 
2793 4766 2261 





Before After 


Condition Code: x 1 





ADD SHORT FLOAT (ASF) 
Instruction Description 


The second operand is added to the first operand 
(two-operand format) or the third operand is added to 
the second operand (three-operand format), and the 
sum is placed in the first operand location. 
Interchanging of the two source operands in 
floating-point addition does not affect the value of the 
sum, but can affect which operand is overwritten. 


Format: SS 


tie) oo jel 
8 12 


0 Bits 16 20 32 36 47 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used, if base 
register O is specified for the third operand. A 
three-operand format is used, if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


The exponents of the two operands are compared. The 
significand of the smaller exponent is shifted right as its 
exponent is increased until the exponents are the same. 
The significands are then added algebraically to form an 
intermediate sum. 


The significand of the intermediate sum is rounded, if 
necessary, according to the rounding mode specified in 
the task dispatching element. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
sum. The source operands are checked for this value in 
order of their specification. The masked not-a-number 
with the larger fraction value is used as the sum. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the sum is determined by the 
rules of algebra. If the sum of two operands that have 
opposite signs is O, the sign is made plus for all 
rounding modes except round toward negative infinity, 
where the sign is made minus. 


Condition Code: The result is compared to 0. Values of 
O compare equal even if they differ in sign. 
Not-a-number values and infinite values compare 
unordered. 


0 Sum =O 
1 Sum <0 
2 Sum >0O 
3 Sum is unordered 


Carry: \f a carry occurs, the sum is shifted right one 
binary digit position with a high-order 1 bit inserted, 
and the exponent increased by 1. 


Boundary Requirements: All operands must be fullword 
aligned; otherwise, a specification exception occurs, and 
the operation is suppressed. 


Operands may overlap if they are coincidental; 
otherwise, the results are unpredictable. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 
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Programming Note: The following chart shows the 
condition of the sum for various operands. 


sum First Source (addend) | Second Source (Addend) 
“0 
“0 foo 
+0 +Real number # 0 -Real number # 0 

+Real number # 0 +0 or -O 

+0 or -O +Real number # 0 


Masked not-a-number Masked not-a-number Not not-a-number 
Masked not-a-number Not not-a-number Masked not-a-number 








Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operation Unmasked not-a-number 
Invalid operation Unmasked not-a-number 


+Infinity +Real number # O or -real | +Infinity 
number # O 
+Infinity +Real number # O or -real 
number # O 
- Infinity +Real number # O or -real | -Infinity 
number # O 
-Infinity -Infinity +Real number # O or -real 
number # O 


Invalid operation +|nfinity or -infinity +Infinity or -infinity 





+0 wo tO Note 
soot ote 2 
motte 2 
Notes: 


1. Value is not rounded toward negative infinity. 
2. Value is rounded toward negative infinity. 
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ASF Example 


Cc Op D, 
AE 060 
O Bits 8 12 16 20 32 36 47 
Assembler: ASF D, (B, ), D, (B, ), B3 
Machine: AE31 4050 4060 
B3(3): 0010 0200 0070 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 


2/A 
0010 0200 0050 XXXX 
0010 0200 0060 2345 
0010 0200 0070 2345 





Storage — After 


C 0010 0200 0050 


0010 0200 O060 
0010 0200 0070 





Before After 
Condition Code: x 2 


Instruction Descriptions 10-31 


AND BYTE (NB) Program Exceptions: 


Instruction Description — Address Translation 
— Addressing 
The first and second operands are ANDed and the result — Effective Address Overflow 


is placed in the first-operand register. 


NB Example 
Format: RS 

Panes 
79 |nliie| 7a_[c|iie| sa 
O Bit 8 12 16 20 31 O Bit 8 12 16 20 31 


Assembler: NBr,, D2(B>) 
Operation: Operands are treated as logical quantities and 


the connective AND is applied bit by bit. A bit position Machine: 79C1 8542 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the B, (8): 1224 1932 0000 


result bit is set to zero. 


Storage — Before and After 


Overflow and Sign Code: Not applicable. 
1224 1932 0542 


Condition Code: 





0 Result = 0 
1 Result # 0 
2 -- Before After 
3 ae 
ry (C): 45 40 
Carry: Not applicable. Condition Code: x 1 


Boundary Requirements: None. 
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AND BYTE IMMEDIATE (NBI) 
Instruction Description 


The first and second operand are ANDed and the result 
is placed in the first-operand location. 


Format: Sl 
O Bits 8 16 20 31 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result # 0 


WON — © 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


NBI Example 
Op l, B, 
98 FF 7 
QO Bits 8 16 20 31 


Assembler: NBI D,(B;,), I. 
Machine: 98FF 7118 


B,(7): 1180 1140 3000 


Storage — Before and After 


1180 1140 3118 


Before After 


Condition Code: x 1 


Instruction Descriptions 
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AND BYTE REGISTER (NBR) 
Instruction Description 
The first and second operands are ANDed and the result 


is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = 0 
1 Result # 0 
y) = 
3 de 
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Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


NBR Example 


Op 
18 
0 Bits 8 12 15 


Assembler: NBR rj, r2 


Machine: 1856 


Before After 
r, (5): FF 21 
r.(6): 21 21 
Condition Code: x 1 








AND BYTE REGISTER IMMEDIATE (NBRI) 
Instruction Description 
The first and second operand are ANDed and the result 


is placed in the first-operand register. 


Format: Rl 


jae tuto] 4» | 
12 


O Bits 8 16 24 31 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = 0 
1 Result # 0 
2 a 
3 — 


Carry: Not applicable. 


Boundary Requirements and Program. Exceptions: None. 
NBRI Example 


Op |r, l, 
48 3 32 
O Bits 8 12 #16 24 31 
Assembler: NBRIr,, I, 
Machine: 4830 3200 
Before After 


r, (3): 4C 00 


Condition Code: x 0 
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AND CHARACTERS (NC) 
Instruction Description 


The first and second operand are ANDed and the result 
is placed in the first-operand location. 


Format: SS 
jes | 4 [el o [e] o, 
O Bits 16 20 32 36 47 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands (operand fields are processed 
left to right) contain a one; otherwise, the result bit is 
set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
O Result = 0 
1 Result # 0 
2 a 
3 es 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
leftmost byte of the first operand is coincident with or 
to the left of the leftmost byte of the second operand; 
otherwise the overlap is destructive and the results are 
unpredictable. 
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Program Exceptions: 


— Address translation 
— Addressing 
~— Effective address overflow 


NC Example 
Op D. 
C8 a 240 
O Bits 16 20 32 36 47 


Assembler: NC D,(L,, B;), D2 (B2) 
Machine: C803 6540 5240 
B,(6): 5010 6400 AOOdO 


B.(5): 5010 6400 BOOO 


Storage — Before 


0/8 2/A 
5010 6400 A540 A1A1 B123 
5010 6400 B240 AlA1 B111 





Storage — After 


0/8 2/A 
5010 6400 A540 A1A1_ B101 
5010 6400 B240 AlA1_ B111 





Before After 


Condition Code: x 1 





AND HALFWORD (NH) 
Instruction Description 
The first and second operand are ANDed and the result 


is placed in the first-operand register. 


Format: RS 


O Bit 8 12 16 20 31 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = 0 
1 Result # 6) 
2 ‘ae 
3 om 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Addressing 


NH Example 


Address translation 


Effective address overflow 
Specification 


Op D, 
80 160 
31 


O Bits 8 12 


16 20 


Assembler: NH R,, D,(B2) 


Machine: 8034 5160 


B2(5): 5718 9423 2000 


5718 9423 2160 


R, (3): 


Condition Code: 


Storage — Before and After 





Before 


008A 


After 


0002 


Instruction Descriptions 
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AND HALFWORD REGISTER (NHR) 
Instruction Description 
The first and second operand are ANDed and the result 


is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result # 0 


ON — O 


10-38 


Carry: Not applicable. ) 


Boundary Requirements and Program Exceptions: None. 


NHR Example 


Op 
28 
0 Bits 8 12 15 


Assembler: NHR R,, R2 
Machine: 2835 


Before After 


R , (3): 008A 0002 
R- (5): 0503 0503 
Condition Code: x 1 





AND HALFWORD REGISTER IMMEDIATE (NHRI) 
Instruction Description 


The first and second operand are ANDed and the result 
is placed in the first-operand register. 


Format: RI 


O Bits 8 12 16 31 


Operation: Operands are treated as logical quantities and 
the connective AND is applied bit by bit. A bit position 
in the result is set to one if the corresponding bit 
positions in both operands contain a one; otherwise, the 
result bit is set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result # 0 


WN — © 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


NHRI Example 

Op 

58 
O Bits 8 12 16 31 
Assembler: NHRIR,, I. 
Machine: 5840 FFFF 

Before After 

R, (4): A1A2 A1A2 


Condition Code: x 1 
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BRANCH AND LINK (BAL) 

Instruction Description 

The updated instruction address is loaded as link 
information in the halfword register designated by R,. 


Subsequently, the instruction address is replaced by the 
branch address. 


Format: Rl 


O Bit 8 12 16 31 


Operation: The branch address is computed before the 
instruction address is loaded. The updated instruction 
address is replaced by the sum of the 16-bit 
displacement D, from the instruction and the offset 
portion of the instruction in base register O. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 


Carry: Not applicable. 
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must start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Boundary Requirements: The updated instruction address ) 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


BAL Example 


D, 
01C6 


O Bit 8 12 16 31 
Assembler: BAL R,,D, 


Machine: 4F30 01C6 


Before Updated After 
B(O): 7314 2482 1130 — 7314 2482 1130 - 
R,(3): xxxx _ «135A 
IAR: 1356 135A 12F6 


BRANCH AND LINK LONG (BALL) 
Instruction Description 


The updated instruction address is loaded as link 
information in the halfword register designated by R,; 
and the instruction stream base address, contained in 
base register O, is loaded in the base register designated 
by B,. Subsequently, the instruction stream base 
address and instruction address are replaced by the 
second operand. 


Format: RS 


0 Bitt 8 12 16 20 31 


Operation: Bits O-F of the second operand contain the 
new instruction address; bits 16-3F contain the new 
instruction stream base address that is loaded into base 
register O. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The second operand occupies 8 
bytes in storage and must start on a fullword boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. Both the instruction stream 
base address and the instruction address must start on 
a halfword boundary; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


BALL Example 
oe ele rs] st 
SF 7D0 

0 Bit 8 12 16 20 31 

Assembler: BALL R,, B3, D2 (B2) 

Machine: 8FEF 07D0 
Before Updated After 

B,(0): 0100 DOOC 0000 — 81BC 4560 0000 

B3(F): xxxx XXXX XXXX — 0100 DOOC 0000 

R,(E): xxxx = 3308 


IAR: 3304 3308 4330 


Storage — Before and After 


0/8 2/A 4/C 6/E 
0100 DOOC 07D0 | 4330 81BC 4560 0000 
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BRANCH INTERNAL (BI) 
Instruction Description 
A branch is taken to the address contained in the 


first-operand register if that address is internal to the 
current segment group. 


Format: RR 


O Bits 8 12 15 


Operation: The left 3 bytes of the first operand are 


compared with the left 3 bytes of B(O) (base register 0). 


If the values are not equal, an invalid segment group 
address exception occurs and the operation is 
suppressed. 


If no exception is signaled, then the following is done: 


1. Bytes 0-3 (the left 4 bytes) of B(O) are set equal 
to bytes 0-3 of the first operand. 


2. Bytes 4-5 of B(O) are set equal to zero. 


3. The IAR is set from bytes 4 and 5 of the first 
operand. 


4, Execution resumes at the new. B(O) and IAR 
location. 
Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements: The first operand must point to 
a halfword boundary; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 


Specification 


BI Example 


O Bits 8 12 15 
Assembler: BI B, 
Machine: 1E30 

Before 
B(O): 1133 6422 0000 
B,(3): 1133 6422 6420 


IAR: 0330 


Invalid segment group address 


After 


1133 6422 0000 


1133 6422 6420 


6420 


2 





BRANCH ON CONDITION (BC) 
Instruction Description 


The updated instruction address is replaced by the 
branch address if the condition code is as specified by 
M,; otherwise, normal instruction sequencing proceeds 
with the updated instruction address. 


Format: RI 
0 Bits 8 12 16 31 


Operation: M, is used as a 4-bit mask. The 4 bits of 
the mask correspond, left to right, with the four 
condition codes (0, 1, 2, and 3). The branch is 
successful when the condition code has a corresponding 
mask bit of 1. A mask of all zeros results in normal 
instruction sequencing. 


The updated instruction address is replaced by the sum 
of the 16-bit displacement (D,) and the offset portion of 
the instruction stream base address contained in the 
base register 0Q. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: The IMP Instruction Assembler uses 
the following extended mnemonics: 


Extended Standard 
Mnemonics Meaning Mnemonic Mask 
BH Branch High BC 2 
BL Branch Low BC 4 
BE Branch Equal BC 8 
BNH Branch Not High BC D 
BNL Branch Not Low’ BC B 
BNE Branch Not Equal BC 7 
BP Branch Positive BC 2 
BM Branch Minus BC 4 
BZ Branch Zero BC 8 
BNP Branch Not Plus BC D 
BNM Branch Not Minus BC B 
BNZ Branch Not Zero BC 7 
BO Branch If Ones BC 1 
BM Branch If Mixed BC 4 
BZ Branch If Zeros BC 8 
BNO Branch If Not BC E 

Ones 
BC Example 

M, D. 

4 0430 
O Bits 8 12 16 31 
Assembler: BC M3, D2 
Machine: 6E04 0430 
Condition Code: 1 

Before After 


B(O): 5425 3111 5100 5425 3111 5100 


IAR: 5860 5530 
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BRANCH ON CONDITION INDIRECT (BCN) 
Instruction Description 


The updated instruction address is replaced by the 
branch address if the condition code is as specified by 
M,; otherwise, normal instruction sequencing proceeds 
with the updated instruction address. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: M, is used as a 4-bit mask. The 4 bits of 
the mask correspond, left to right, with the four 
condition codes (0, 1, 2, and 3). The branch is 
successful when the condition code has a corresponding 
mask bit of 1. A mask of all zeros results in normal 
instruction sequencing. 


The halfword at the second-operand location contains 
the branch displacement. The branch address is formed 
by adding the branch displacement to the offset portion 
of the instruction stream base address contained in base 
register O. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements: The halfword storage operand 

and the updated instruction address must each start on 2 
a halfword boundary; otherwise a specification exception 

occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


BCN Example 

B, 

Cc 
O Bit 8 12 16 20 31 
Assembler: BCN M3, D2 (B;) 


Machine: 9E02 C310 


Before Updated After 
B(O): 0023 1430 5680 — 0023 1430 5680 2 
B2(C): 0114 1180 4000 — 0114 1180 4000 
IAR: 6234 6238 6EDO 


Condition Code: 2 


Storage — Before and After 


0114 1180 4310 





BRANCH ON CONDITION INDIRECT INDEXED 
(BCNX) 


Instruction Description 


The updated instruction address is replaced by the 
branch address if the condition code is as specified by 
the mask; otherwise, normal instruction sequencing 
proceeds with the updated IAR. 


Format: RS 
O Bits 12 16 20 31 


Operation: M, is used as a 4-bit mask. The 4 bits of 
the mask correspond, left to right, with the four 
condition codes (0, 1, 2, and 3). The branch is 
successful when the condition code has a corresponding 
mask bit of 1. A mask of all zeros results in no branch. 


The contents of the halfword register specified by R, is 

added to the effective address of the second operand to 
form the address of a halfword in storage that contains 

the branch displacement. The branch address is formed 
by adding the branch displacement to the offset portion 

of the instruction stream base address contained in base 
register 0. 


Overflow: An overflow is recognized as an effective 
address overflow exception, and the operation is 
suppressed. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The halfword storage operand 
and the updated instruction address must each start on 
a halfword boundary; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


BCNX Example 


O Bits 12 16 20 
Assembler: BCNX R,, M3, D> (Bz) 
Machine: 7FB8 4630 
Before Updated After 

B(O): 0023 1430 5680 — 0023 1430 5680 
B.(4): 0375 2102 6000 — 0375 2102 6000 
R,(B): 4C20 — 4C20 

IAR: 75CO 75C4 7060 


Condition Code: 0 


Storage — Before and After 


0375 2102 B250 





Instruction Descriptions 10-45 


BRANCH ON COUNT (BCT) 
Instruction Description 


The binary quantity contained in the halfword register 
specified by R, is reduced by 1. When the result is 
zero, normal instruction sequencing proceeds with the 
updated instruction address. When the result is not 
zero, the instruction address is replaced by the branch 
address. 


Format: RI 


O Bit 8 12 16 31 


Cperation: The updated instruction address is replaced 
by the sum of the 16-bit displacement D, from the 
instruction and the offset portion of the instruction 
stream base address contained in base register 0, if R, 
does not equal zero. 


The branch address is computed before the counting 
operation. Counting does not change the condition 
code. The subtraction proceeds as in binary arithmetic 
and all 16 bits of the halfword register participate in the 
operation. 


Overflow: The overflow occurring on transition from 
maximum positive number is ignored. 


Sign Code: Not applicable. 
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Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 


— Addressing 
— Effective address overflow 
— Specification 
BCT Example 
Op /|R, D, 
8E C 02A0 
O Bits 8 12 16 31 


Assembler: BCT R,, D2 
Machine: 8ECO O2A0 
Before Updated After 
R,(C): 0009 — 0008 
IAR: IEFO 1EF4 12C0 


B(O): OOOA 2130 1020 — OOOA 2130 1020 





BRANCH REGISTER (BR) 
Instruction Description 


The instruction address is replaced by the contents of 
the halfword register designated by R,. 


Format: RR 


O Bits 8 12 15 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Ccde: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 


must start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 
— Address translation 


— Addressing 
— Specification 


BR Example 

Op |R, 

2E Cc 
O Bits 8 12 15 
Assembler: BR Ry, 
Machine: 2ECO 

Before After 

R,(C): 5320 5320 


IAR: 3252 5320 


Instruction Descriptions 
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BRANCH REGISTER LONG (BRL) 

Instruction Description 

The instruction address is replaced by the contents of 
the halfword register designated by R,; the instruction 
stream base address, contained in base register O, is 


replaced by the contents of the base register designated 
by B.. 


Format: RR 


O Bits 8 12 15 


Operation: See Instruction Description 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 
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Program Exceptions: 
— Address translation 


— Addressing 
— Specification 


BRL Example 


0 Bits 8 12 15 
Assembler: BRL R,,B, 
Machine: 2F95 

Before After 
R,(9): 14E0 14E0 
B,(5): 32A3 57C9 OO000 32A3 57C9 0000 
IAR: 2344 14E0 


B(O): 21F2 334A Q000 32A3 57C9 Q000 





BRANCH UNCONDITIONAL (BU) 
Instruction Description 
The updated instruction address is replaced by the 


branch address. 


Format: RI 


0 Bit 8 12 16 31 


Operation: The branch address is the sum of the 16-bit 
displacement D, from the instruction and the offset 
portion of the instruction stream base address contained 
in base register O. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise a 
specification exception cccurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: The IMP instruction assembler uses 
the extended mnemonic B meaning branch 
unconditional. 


BU Example 

Op D, 

6F 11BO 
O Bits 8 12 16 31 
Assembler: BU D, 
Machine: 6FOO 11B0 

Before After 

B(O): 1B30 2CCO 0100 


1B30 2CCO 0100 


IAR:  0OB20 12B0 
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CALL INTERNAL (CALLI) 


Instruction Description 


The second operand identifies a branch target. After 
execution of this instruction the updated instruction 
address is replaced by the sum of the second operand 
and the offset portion of base register 0. 


Format: Sl 
O Bits 12 16 20 32 47 


Operation: The first operand points to a 16-byte area in 
storage, where the instruction creates a tagged pointer 
containing the return address by putting the leftmost 
two bits of |, into bits O and 1 of byte O of the tagged 
pointer. The return address points to the next 
instruction, which resides in the storage area 
immediately following the CALLI instruction. After the 
two bits from |, are put into byte O of the tagged 
pointer, the instruction zeros bits 2-7 of byte O of the 
tagged pointer. Bytes 8 and 9 are fetched from the 
storage location whose address is formed by 
concatenating hex O00 0004 to the right of the leftmost 3 
bytes of base register 0. Pointer bytes 10-15 are loaded 
with the return address formed from the 2-byte updated 
IAR contents concatenated to the right of the leftmost 4 
bytes of base register 0. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The tag pointer must be 
quadword aligned; otherwise, a specification exception 
occurs and the operation is suppressed.- 
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Program Exceptions: } 


Address translation 
Addressing 

Effective address overflow 
Specification 


CALLI Example 


Op D, 
EF 11BO 
0 Bits 16 20 32 47 


Assembler: CALLI D,(B,), D2, I3 


Machine: EF40 5100 11BO 


Before After 
B(O): 1B30 2CCO 0000 1B30 2CCO 0000 
B(5): 1A40 0000 0000 1A40 0000 0000 
IAR: OB20 11BO 
Address Before After .) 
1A40 0000 0100 XXXX XXXX 4000 0000 
XXXX XXXX 0000 0000 
XXXX XXXX 1234 1B30 
XXXX XXXX 2CCO 0B26 
1B30 2CCO 0004 1234 1234 
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COMPARE AND SWAP HALFWORD (CSH) 
Instruction Description 


The first and second operands are compared. If they are 
equal, the third operand is stored in the second-operand 
location. If they are unequal, the second operand is 
loaded into the first-operand location. 


Format: RS 
7 |rir|e| o, _ 
0 Bits 8 12 16 20 31 


Operation: The first and third operands are 16 bits in 
length, with each operand occupying a halfword register. 
The second operand is a halfword in main storage. 


The result of the 16-bit comparison, either equal or 
unequal, is used to set the condition code. When the 
result of the comparison is unequal, no attempt to store 
occurs. 


When an equal comparison occurs, no access by 
another instruction is permitted at the second-operand 
location between the moment that the second operand 
is fetched for comparison and the moment that the third 
operand is stored at the second-operation location. 
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Overflow and Sign Code: Not applicable. 


Condition code: 
O First = Second operand; second operand 
Operand replaced by third operand. 
1 First # Second operand; first operand 
Operand replaced by second operand. 
2 = 
3-- 


Carry: Not applicable. 


Boundary Requirements: The second operand must be 
on a halfword boundary; otherwise, a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: The Compare and Swap Halfword 
instruction does not interlock against storage accesses 
by the channel. Therefore, the instruction should not be 
used to update a halfword that is partly or entirely in an 
|/O input area, since the input data may be lost. 


CSH Example 


Op 
7D 


O Bit 8 12 16 20 31 


Assembler: CSH R,, R3, D2 (B,) 
Machine: 7D56 3330 

B2 (3): 1072 92D0 E000 

R, (5): 58F3 


R3 (6): 845F 


Storage — Before 


1072 92D0 E330 





Storage — After 


1072 92D0 E330 





Before After 


Condition Code: x 0 
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COMPARE BYTE IMMEDIATE AND BRANCH 
EQUAL (CBIBE) 


Instruction Description 


The first operand is compared with the second operand. 
If the operands are equal, the updated instruction 
address is replaced by the branch address; otherwise, 
normal instruction sequencing proceeds with the 
updated instruction address. 


Format: Sl 
O Bits 16 20 32 47 


Operation: The immediate operand, |,,, is compared with 
the byte in storage addressed by B,, D,. If equal, the 
updated instruction address is replaced by the sum of 
the 16-bit displacement (D,) and the offset portion of 
the instruction stream base address contained in base 
register zero. 


Overflow and Sign Codes: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise, a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 
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CBIBE Example 


Op D, 
DO 4928 


0 Bits 16 20 32 4/7 


Assembler: CBIBE D, (B,), 12, D3 
Machine: DOE8 3009 4928 
B(O): 3978 21F4 0100 


B(3): 49E2 C301 0200 


Storage — Before and After 


49E2 C301 0209 


Before After 


IAR:  O093C 4A28 





wot 





COMPARE BYTE IMMEDIATE AND BRANCH NOT 
EQUAL (CBIBN) 


Instruction Description 


The first operand is compared with the second operand. 
If the operands are equal, the updated instruction 
address is replaced by the branch address; otherwise, 
normal instruction sequencing proceeds with the 
updated instruction address. 


Format: Sl 


O Bits 


16 20 32 47 


Operation: The immediate operand, |,, is compared with 


the byte in storage addressed by B,, D,. 


If not equal, 


the updated instruction address is replaced by the sum 
of the 16-bit displacement (D,) and the offset portion of 
the instruction stream base address contained in base 
register zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must start on a halfword boundary; otherwise, a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


CBIBN Example 


Op 
D1 


Bits 16 20 32 47 


Assembler: CBIBN D,(B,); Iz, D3 
Machine: D1E8 4005 4E31 
B(O): 56B3 4792 5AC4 


B(4): 359D 0200 4EC8 


Storage — Before and After 


359D 0200 4ECD 





Before After 


IAR: 6FO2 6FO08 
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COMPARE CHARACTERS (CC) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: SS 
-ez tulyte| |e] 
O Bits 16 20 32 36 47 


Operation: Comparison is algebraic, treating both 
operands in signed binary quantities. Operands in 
registers or storage are not changed. If the operands 
are unequal in length, the shorter operand is considered 


to be extended to the left with bits equal to the sign bit. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
Zoos 


< 
> 


Carry: Not applicable. 
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Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


CC Example 
Op 
C2 
O Bits 16 20 32 36 47 


Assembler: CC D,(L,,B,), D2(L2, B2) 
Machine: C233 4320 5130 
B, (4): 1ABC 2DEF 0000 
B2 (5): 312B 45C6 0000 


Storage — Before and After 


0/8 2/A 4/C 6/E " 
1ABC 2DEF 0320 8125 B2CC 2 


312B 45C6 0130 


7ACO 465F 





Before After 


Condition Code: x 1 


COMPARE HALFWORD (CH) 
instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RS 


12 


0 Bits 8 16 20 31 


Operation: Comparison is algebraic, treating both 
operands as signed binary quantities. Operands in 
registers or storage are not changed. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand 
1 First operand 
2 First operand 
< 


Second operand 
Second operand 
Second operand 


VA ill 


Carry: Not applicable. 


Boundary Requirements: The storage operands must 
start on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Addressing 


CH Example 


0 Bits 


Address translation 


16 20 


Effective address overflow 
Specification 


Op |R, D. 
80 7 BCO 
8 12 31 


Assembler: CH Ri, D, (B2) 


Machine: 8072 2BCO 


B,(2): OOAO 3120 0000 


R,(7): 1AF3 


OOAO 3120 OBCO 


Condition Code: 


Storage — Before and After 


Before 


xX 


After 


2 


Instruction Descriptions 
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COMPARE HALFWORD IMMEDIATE (CHI) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: Sl 
Ls | [ole|_o | 4 _ 
O Bits 8 16 20 32 47 


Operation: Comparison is algebraic, treating both 
operands as signed binary quantities. Operands in 
registers or storage are not changed. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
2 oe 


VA 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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Program Exceptions: 


Address translation 


— Addressing 
— Effective address overflow 
— Specification 
CHI Example 
Op I, 
A2 ee B13C 
0 Bits 16 20 47 


Assembler: CHI D,(B,), la 
Machine: A200 7A10 B13C 


B,(7): OOOA 24B0 0000 


Storage — Before and After 


OOOA 24B0 0A10 





Before After 


Condition Code: x 0 





C 


COMPARE HALFWORD REGISTER (CHR) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RR 


O Bits 8 12 15 


Operation: Comparison is algebraic, treating both 
operands as signed binary quantities. Operands in 
registers are not changed. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
a == 


VA 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


CHR Example 


QO Bits 8 12 15 
Assembler: CHR R,, R2 


Machine: 2234 


R,(3): 5590 
R(4): 8320 

Before After 
Condition Code: x 2 
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COMPARE HALFWORD REGISTER IMMEDIATE 
(CHRI) 

Instruction Description 

The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RI 


0 Bitt 8 12 16 31 


Operation: Comparison is algebraic, treating both 
operands as signed binary quantities. Operands in 
registers are not changed. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
Buss 


VA 
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Carry: Not applicable. 





Boundary Requirements and Program Exceptions: None. 


CHRI Example 
I, 
2243 
O Bits 8 12 16 31 
Assembler: CHRI R,, I, 
Machine: 5290 2243 
R,(9): 2233 
Before After 


Condition Code: x 1 








COMPARE LOGICAL ADDRESS REGISTER (CLAR) 


Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. 


Format: RR 


_ 23 [ele 


O Bits 8 12 15 


Operation: The two 6-byte operands are treated as 
unsigned binary integers and are compared, setting the 
condition code in the following manner. 


First, the high-order 3 bytes (segment group) of the two 
Operands are compared; if they are not equal, the 
condition code is set to 3 and the instruction is 
complete. If the operands are equal, the low-order 3 
bytes (segment group offset) of the operands are 
compared as unsigned binary integers. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 First operand = Second operand. 


1 High-order 3 bytes of the operands are equal; 
low-order 3 bytes of the first operand are low. 


2 High-order 3 bytes of the operands are equal; 
low-order 3 bytes of the first operand are high. 


3 High-order 3 bytes of the operands are not 
equal. 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


CLAR Example 
she 
23 8 

O Bits 8 12 15 

Assembler: CLAR B, ,B2 
Machine: 2386 

B, (8): 00C1 BOOO 4BE0 
B,(6): 00C1 BOOO 4BD0 

Before After 


Condition Code: x 2 
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COMPARE LOGICAL BYTE (CLB) Boundary Requirements: None. 


Instruction Description 
Program Exceptions: 
The first operand is compared with the second operand, 
and the result determines the setting of the condition — Address translation 
code. — Addressing 
— Effective address overflow 


Format: RS 


CLB Example 
pn |alele| o 
8 12 


0 Bits 16 20 31 Op 
71 
12 


ee Ora 7 
Operation: The comparison is performed with the Bia? «6 16 20 3 


operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


Assembler: CLBr,, D2 (B>) 
Machine: 7182 6120 


B2(6): 4022 4045 0000 
Overflow and Sign Code: Not applicable. 


V4 (8): 27 
Condition Code: 


Storage — Before and After 


Second operand 


Second operand 4022 4045 0120 
Second operand 


O First operand 
1 First operand 
2 First operand 
ose 


VA ll 





Carry: Not applicable. 
Before After 


Condition Code: x 0 
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COMPARE LOGICAL BYTE IMMEDIATE (CLBI) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
codes. 


Format: Sl 
joc |. [al vo 
O Bits 8 16 20 31 


Operation: The comparison is performed with the 
operands as unsigned binary quantities. Operands in 
registers or storage are not changed by the operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
cae 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


CLBI Example 

Op 

9C 
O Bits 8 16 20 31 
Assembler: CLBI D,(B,), I, 
Machine: 9C03 4032 


B, (4): 4128 7147 0000 


Storage — Before and After 


4128 71A7 0032 


Before After 


Condition Code: x 2 


Instruction Descriptions 
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COMPARE LOGICAL BYTE REGISTER (CLBR) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RR 


O Bits 8 12 15 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers are not changed by the operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand 
1 First operand 
2 First operand 
a ae 


Second operand 
Second operand 
Second operand 


VA ll 
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Carry: Not applicable. : 


Boundary Requirements and Program Exceptions: None. 


CLBR Example 


O Bits 8 12 15 
Assembler: CLBR r,,r2 


Machine: 1234 


r,(3): 42 
r2(4): 42 

Before After 
Condition Code: x 0 


COMPARE LOGICAL BYTE REGISTER IMMEDIATE 
(CLBRI) 

Instruction Description 

The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RI 


ja talo] y | 
8 12 


0 Bits 16 24 31 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
Ca 


VA 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


CLBRI Example 


O Bits 8 12 16 24 31 


Assembler: CLBRI r,, I. 
Machine: 4250 FFOO 
r,(5): F4 

Before After 


Condition Code: x 1 
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COMPARE LOGICAL CHARACTERS (CLC) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


The operation proceeds left to right and ends as soon 
as an inequality is found or an end of the field is 
reached. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
2 25 


VA 


Carry: Not applicable. 
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Boundary Requirements: The first and second operands 

can overlap in storage. If either operand crosses a 2 
segment boundary, an effective address overflow 

exception occurs and the operation is suppressed. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


CLC Example 
Op B, D, 
C5 7 000 
O Bits 16 20 32 36 47 


Assembler: CLC D,(L,, B,), D2(B2) 
Machine: C500 2001 7000 
B,(2): 4417 8418 0000 


B2(7): 4417 5232 0000 


Storage — Before and After eal 


4417 5232 0000 
4417 8418 0001 





Before After 


Condition Code: x 2 


COMPARE LOGICAL CHARACTER REGISTER 
(CLCR) 


Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. The length is variable and is found as the 
contents of the third operand byte register. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


The operation proceeds left to right and ends as soon 
as an inequality is found or an end of the field is 
reached. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
2 we 


VOA 


Carry: Not applicable. 


Boundary Requirements: The first and second operands 
can overlap in storage. If either operand crosses a 
segment boundary, an effective address overflow 
exception occurs and the operation is suppressed. 


Program Exceptions: 


— Address translation 


— Addressing 


— Effective address overflow 


CLCR Example 


B, D, 
7 000 


O Bits 


16 20 


32 36 


Assembler: CLCR D,(B;), D, (B,), R3 


R3(5): 00 


Machine: E950 2001 7000 
B,(2): 4417 8418 0000 


B,(7): 4417 5232 0000 


4417 5232 0000 
4417 8418 0001 


Condition Code::. 


Storage — Before and After 


47 





Before After 


Xx 


Instruction Descriptions 
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COMPARE LOGICAL CHARACTERS LONG (CLCL) 
Instruction Description 
The first operand is compared with the second operand 


and the result is indicated in the condition code. 


Format: SS 


peat, [el o Jel o 


0 Bits 8 16 20 32 36 47 


Operation: The shorter operand is considered extended 
to the right with the padding character contained in the 
|, field of the instruction. 


The leftmost bytes of the first and second operands as 
well as the lengths are located indirectly through 
addresses contained in storage. These addresses are 
8-byte fields. Bytes 0-1 of these 8-byte fields specify 
1 less than the number of bytes in the operand location; 
bytes 2-7 contain the address of the leftmost byte of 
the operand. 









Operand Address 





Length 











SID Offset 


0 Bytes 2 7 


The comparison is performed with the operands treated 
as unsigned binary quantities. The operation proceeds 
left to right and ends as soon as an inequality is 
detected or the end of the longest operand is reached. 
If the operands are not of the same length, the shorter 
operand is assumed to be extended to the right with the 
padding character. 
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If the 8-byte field associated with either field contains 

all zeros, the operand is assumed to be of zero length J 
and the padding character is used for the entire field. If 

both 8-byte fields contain all zeros, condition code O is 

set. 





The execution of the instruction is interruptible (the 
operation can be suspended). When an interruption 
occurs after a unit of operation other than the last one, 
the IAR is not advanced to the next instruction address, 
the length fields are decremented by the number of 
bytes compared, and the address fields are incremented 
by the same number, so that the instruction, when 
reexecuted, resumes at the point of interruption. If the 
operation is interrupted after the shorter operand has 
been exhausted, the length and address fields for that 
operand are all zeros. 


If the operation ends because of a mismatch, the length 

and address fields at completion identify the byte of 

mismatch. The length counts are decremented by the 

number of bytes that matched, and the address fields 

are incremented by the same amount. If the mismatch 

occurred with the padding character, the length and 

address fields of the shorter operand contain all zeros. 

If the two operands including the padding character are 

equal, then the length and address fields for both 
operands contain all zeros. 2 


Overflow and Sign Code: Not applicable. 


Condition Code: The condition code is not set by this 
instruction until it has completed. Therefore, if the 
instruction was interrupted, no mismatch has occurred 
up to this point. 


OQ First operand = Second operand, or both 
fields are of zero length 

First operand < Second operand 

2 First operand > Second operand 

3 -- 


= 





Carry: Not applicable. 


Boundary Requirements: The leftmost byte of each 
operand address identifies an 8-byte field in storage 
that must begin on a word boundary and must not cross 
a page boundary; otherwise a specification exception 
occurs and the operation is suppressed. The operand 
fields can overlap in storage but neither may cross a 
segment boundary; otherwise an effective address 
overflow exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


CLCL Example 
Op D, D, 
EA 000 7BO 
0 Bits 8 16 20 32 36 47 
Assembler: CLCL D,(B,), Dz (Bz), I3 
Machine: EAFF 4000 47B0 


B, (4) and B, (4): 6250 2938 0000 


Storage — Before 


0/8 2/A 
6250 2938 0000 0003 6250 
6250 2938 07B0 0007 6250 





Storage — After 

0/8 2/A 

6250 2938 0000 0000 O000 
6250 2938 07BO 0003 6250 





Storage — Before and After 
0/8 2/A 4/C 
6250 2A00 0000 1234 5678 
6250 2B00 QO000 1234 5678 9ABC 





Before After 


Condition Code: x 2 
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COMPARE LOGICAL HALFWORD (CLH) 
Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand 
1 First operand 
2 First operand 
2s. 


Second operand 
Second operand 
Second operand 


VA ill 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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Program Exceptions: 


Address translation 2 


— Addressing 
— Effective address overflow 
— Specification 
CLH Example 
D, 
280 
O Bits 8 12 16 20 31 


Assembler: CLH R;, D, (Bz) 
Machine: 9230 4280 
B,(4): 9046 71A2 0000 


Storage — Before and After 


9046 71A2 0280 





Before After 


Condition Code: x 0 





COMPARE LOGICAL HALFWORD IMMEDIATE 
(CLHI) 


Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: Sl 
O Bits 12 16 20 32 47 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
3 oe 


VA 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


CLHI Example 


Op 
B2 


O Bits 12 16 20 32 47 
Assembler: CLHI D,(B,), Io 
Machine: B200 3A90 F1F3 


B, (3): 9046 2140 A000 


Storage — Before and After 


9046 2140 AA90 





Before After 


Condition Code: x 1 
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COMPARE LOGICAL HALFWORD REGISTER (CLHR) 
Instruction Description 
The first operand is compared with the second operand, 


and the result determines the setting of the condition 
code. 


Format: RR 


O Bits 8 12 15 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers are not changed by the operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand 
1 First operand 
2 First operand 
: 


Second operand 
Second operand 
Second operand 


vail 
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Carry: Not applicable. 
) 


Boundary Requirements and Program Exceptions: None. 


CLHR Example 


O Bits 8 12 15 
Assembler: CLHR R,, R2 


Machine: 3234 


R,(3): 2C3E 
R2(4): 2C3E 

Before After 
Condition Code: x 0 





COMPARE LOGICAL HALFWORD REGISTER 
IMMEDIATE (CLHRI) 


Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. 


Format: RI 


O Bits 8 12 16 31 


Operation: The comparison is performed with the 
operands treated as unsigned binary quantities. 
Operands in registers or storage are not changed by the 
operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand 
1 First operand 
2 First operand 
B22 


Second operand 
Second operand 
Second operand 


VA it 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


CLHRI Example 


I, 
111C 
16 31 


O Bits 8 12 
Assembler: CLHRI R,, Il, 
Machine: 6250 111C 
R, (5): 111F 
Before After 


Condition Code: x 2 
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COMPARE LONG FLOAT (CLF) 
Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. 


Format: SS 


ole] oo jel o 
8 12 


O Bits 16 20 32 36 47 


Operation: Comparison is algebraic, considering the sign, 
the significand, and the exponent of each operand. 
Neither operand is changed as a result of operation. 

The comparison is made following the rules of 
floating-point subtraction as follows. The subtrahend is 
subtracted from the minuend; if the difference is O, they 
compare equal. If the subtrahend is larger than the 
minuend, then the first operand is low. If the 
subtrahend is smaller than the minuend, then the first 
operand is high. 


Floating-point values of O compare equal with each 
other even when they have different signs. 
Floating-point values of infinity compare equal with each 
other even when they have different signs, and a 
floating-point value of infinity compares unordered with 
any other floating point value. A not-a-number 
floating-point value compares unordered with all other 
values including another not-a-number value. 


If a denormalized floating-point number is compared, 


the comparison is made as if the denormalized number 
had first been normalized. 
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Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
3 Operands are unordered 


Carry: Not applicable. 


Boundary Requirements: Both operands must be 
fullword aligned; otherwise, a specification exception 
occurs, and the operation is suppressed. 


Operands may overlap only if they are coincidental: 
otherwise, the results are unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Floating-point invalid operand 
Specification 


Programming Note: The following is a summary of the 
results for various combinations of operands. 





Second Source (Subtrahend) 
finity 
Comparison Result First Source (Minuend) 


+0 
+0 
+Real number # O -Real number # O 
+Real number #0 +0 
An 


+Real number # O 


+Real number # O 


-o | +Real number ¥ 0 


-Real number # O 


-Real number # O 


+0 
+0 
+0 
+0 
Any 
Any 


-Real number # O 


Unordered Masked not-a-number y 


-Real number # O 


-Real number # O +Real number # O 


Unordered lary sti(‘sSCSC*d Masked not-a-number 

See note Unmasked not-a-number__| Any 

See note Any Unmasked not-a-number 
+nfinity 
-Infinity 
+Infinity 
-Infinity 

Unordered +Infinity 

Unordered - Infinity 


Unordered Not infinity 


Unordered Not infinity 


Legend: 
Not Infinity = Anything but infinity or an unmasked not-a-number. 
Any = Any floating-point field value. 


eo 
pe 
Sd 
Se 
[Unordered 
[Unordered 
[Seenote 
[Seenote 
So 
eT 
es 
pe 
[Unordered 
[Unordered 
[Unordered 


Note: An unmasked not-a-number value results in a floating-point invalid operation 
exception unless the exception is masked. An unmasked not-a-number value results in an 
unordered comparison result if the floating-point invalid operation excpetion is masked. 
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CLF Example 
Op B, D, 
CE 4 060 
O Bit 8 12 16 20 32 36 47 
Assembler: CLF D, (B,), Dz (Bz) 
Machine: CEQO 4050 4060 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 
0/8 2/A 


0010 0200 0050 4000 0000 
0010 0200 O060 4000 0000 





Storage — After 
0/8 2/A 


0010 0200 0050 4000 0000 
0010 0200 0060 4000 0000 





Before After 
Condition Code: X 0 
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COMPARE PACKED (CP) 
Instruction Description 


The first operand is compared with the second operand 
and the result is indicated in the condition code. 


Format: SS 
(2 tint! Ie] o 
O Bits 16 20 32 36 47 


Operation: The comparison is algebraic including the 
signs and all digits of both operands. All digit codes are 
checked for validity. Invalid digit codes cause a data 
exception and the operation is terminated. If the fields 
are unequal in length, the shorter field is considered 
extended to the left with zeros. 


Overflow: Not applicable. 


Sign Code: All sign codes are checked for validity, and 
any valid plus or minus sign is considered equal to any 
other plus or minus sign, respectively. Invalid sign codes 
cause a data exception and the operation is terminated. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
ee 


VA 


Carry: Not applicable. 


Boundary Requirements: The first and second-operand 
fields can overlap when their rightmost bytes coincide. 
Because digit and sign codes are checked for validity, 
improperly overlapping fields cause data exceptions, and 
the operation is terminated. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Effective address overflow 


CP Example 
Op D, 
F2 570 
O Bits 16 20 32 36 47 


Assembler: CP D, (L,, B, ), D,(L2, B2) 
Machine: F243 3410 4570 
B, (3): 45C8 6928 5000 


B.(4): 45C8 6053 4000 


Storage — Before and After 


0/8 2/A 4/C 6/E 
45C8 6053 4570 6121 521F 
45C8 6928 5410 7061 2152 = 1F 





Before After 


Condition Code: x 2 
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COMPARE SHORT FLOAT (CSF) 


Instruction Description 


The first operand is compared with the second operand, 
and the result determines the setting of the condition 
code. 


Format: SS 


8 12 


0 Bits 16 20 32 36 47 


Operation: Comparison is algebraic, considering the sign, 
the significand, and the exponent of each operand. 
Neither operand is changed as a result of operation. 

The comparison is made following the rules of 
floating-point subtraction as follows. The subtrahend is 
subtracted from the minuend; if the difference is 0, they 
compare equal. If the subtrahend is larger than the 
minuend, then the first operand is low. If the 
subtrahend is smaller than the minuend, then the first 
operand is high. 


Floating-point values of O compare equal with each 
other even when they have different signs. 
Floating-point values of infinity compare equal with each 
other even when they have different signs, and a 
floating-point value. A not-a-number floating-point 
value compares unordered with all other values including 
another not-a-number. 


If a denormalized floating-point number is compared, 


the comparison is made as if the denormalized number 
had first been normalized. 
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Overflow and Sign Code: Not applicable. 


Condition Code: 


O First operand = Second operand 
1 First operand < Second operand 
2 First operand > Second operand 
3 Operands are unordered 


Carry: Not applicable. 


Boundary Requirements: Both operands must be 
fullword aligned; otherwise, a specification exception 
occurs, and the operation is suppressed. Operand may 
overlap only if they are coincidental; otherwise, the 
results are unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Floating-point invalid operand 
Specification 


Programming Note: The following is a summary of the 
results for various combinations of operands. 








Comparison Result First Source (Minuend) Second Source (Subtrahend) 
~o 2 -—Ci‘“CS™C‘*diSG 


+0 


-Real number # O +Real number # 0 


+ 
+Real number # O -Real number # O 
+Real number # O - 


+Real number # O 


+0 
+0 
+Real number # 0 
+0 
An 


+Real number # O 


0 
-Real number # O 0 


-Real number # O 


-Real number # O 


-o Real number # 0 


+ 
Unordered Masked not-a-number Any 
Unordered Masked not-a-number 
y 


See note [Unmasked not-a-number | 
See note Unmasked not-a-number 
infinity | nity 
-Infinity 
+nfinity 
- Infinity 

Unordered +Infinity 

Unordered - Infinity 
+Infinity Not infinity 


Unordered 


Legend: 
Not Infinity = Anything but infinity or an unmasked not-a-number. 
Any = Any floating-point field value. 


[Comparison Result 
a 
So 
pe 
Se 
[Unordered 
[Unordered 
[Seenote 
[Seenote 


Note: An unmasked not-a-number value results in a floating-point invalid operation 
exception unless the exception is masked. An unmasked not-a-number value results in an 
unordered comparison result if the floating-point invalid operation excpetion is masked. 
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CSF Example 


D, 
060 
8 


0 Bits 12 16 20 32 36 47 
Assembler: CSF D, (B,), D,(B,) 

Machine: AEOO 4050 4060 

B, (4) and B, (4): 0010 0200 0000 


Storage — Before 
0/8 2/A 


0010 0200 0050 4000 0000 
0010 0200 0060 C000 0000 





Storage — After 

0/8 2/A 

0010 0200 0050 4000 0000 
0010 0200 0060 Cooo 0000 





Before After 
Condition Code: x 2 
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COMPUTE ADDRESS LONG (CAL) 
Instruction Description 


The value located in storage by the second-operand 
address is used as a signed displacement to be added 
to the address value in the base register identified by 
the third operand; the resultant address is placed in the 
base register identified by the first operand. 


Format: RS 


jac jejeje) 
8 12 


0 Bits 16 20 31 


Operation: The displacement value is a 32-bit signed 
integer, occupying 4 bytes of storage at the 
second-operand location. 


The address computation is performed as follows. The 
rightmost 3 bytes of the address value [fj identified by 
the third operand are logically padded on the left with 1 
byte of zeros. The displacement identified by the 
second operand is then added to this value following 
the rules of signed arithmetic. The result of this 
calculation Kj must satisfy the following validity checks: 


e Must not be greater than a value of 16 megabytes 
less 1 (FF FFFF or decimal 16 777 215). 


« Must be a positive result. 


e Must not be less than the value of the 3-byte logical 
binary field in storage located at the address [Eq 
determined by concatenating hex 00 001D on the 
right of the leftmost 3 bytes of the third-operand 
address value. 
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If any of the above checks fail, an invalid segment group 
address exception occurs and the operation is 
suppressed. Otherwise, the rightmost 3 bytes of the 
calculated result are concatenated on the right with the 
leftmost 3 bytes of the third-operand address value 
forming the resultant address Ei. No storage reference 
is made using the resultant address placed in the first 
operand, so that the address is not inspected for 
addressing exceptions. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must start 
on a fullword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Invalid segment group address 
Specification 


{ 


2 





CAL Example 


Op /B,| B, |B, D, 

4C 3},5|4 100 
O Bits 8 12 16 20 31 
Assembler: CAL B,, B;,D, (B,) 
Machine: 4C35 4100 


Before After 


B, (3): xxxx xxxx xxxx 0450 63F7 D854] 







B2(4): 0758 71D2 0000 0758 71D2 0000 


B3(5): 0450 63E4 0000 0450 63E4 0000 





0013 0000 
FFFF D854 | 


Eq [00F7 De54] 









N\ 
5 


Storage — Before and After 






0/8 2/A 4/C 


0450 6300 001D 04 










0000 
0013 


1D 
D854 





0758 71D2 0100 
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COMPUTE ADDRESS LONG HALFWORD (CALH) 


Instruction Description 


The value located in storage by the second-operand 
address is used as a signed displacement to be added 
to the address value in the base register identified by 
the third operand; the resultant address is placed in the 
base register identified by the first operand. 


Format: RS 


12 


QO Bits 8 16 20 31 


Operation: The displacement value is a 16-bit signed 
integer on a halfword boundary. If the integer is not 
halfword aligned, a specification exception is recognized 
and the operation is suppressed. The sign bit is 
propagated through the third and fourth (left) offset 
bytes, and a 4-byte signed binary add is performed. 


The address computation is performed as follows. The 
rightmost 3 bytes (segment group offset) of the address 
value [fj identified by the third operand are logically 
padded on the left with 1 byte of zeros, creating a 
positive 4-byte binary integer. The displacement 
identified by the second operand [BY is then added to 
this value following the rules of signed arithmetic. The 
result of this calculation [J must satisfy the following 
validity checks: 


« Must not be greater than a value of 16 megabytes 
less 1 (hex FF FFFF or decimal 16 777 215). 


e« Must be a positive result. 


« Must not be less than the value of the space locator 
offset, 3-byte logical binary field in storage located at 
the address [EJ determined by concatenating hex 00 
001D on the right of the leftmost 3 bytes of the 
third-operand address value. 
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If any of the above checks fail, an invalid segment group 
address exception occurs and the operation is 
suppressed. Otherwise, the rightmost 3 bytes of the 
calculated result are concatenated on the right with the 
leftmost 3 bytes of the third-operand address value 
(segment group identifier) forming the resultant address 
I. No storage reference is made using the resultant 
address placed in the first operand, so that the address 
is not inspected for addressing exceptions. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must start 
on a halfword boundary; otherwise, a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Invalid segment group address 
Specification 





C 


0450 6300 001D 


CALH Example 


Op |B, D, 
4D 8 102 
O Bits 8 12 16 20 31 
Assembler: CALH B,, B3,D,(B,) 
Machine: 4D85 4102 


Before After 


B, (8): xxxx xxxx xxxx 0450 63E3 D854] 







B2(4): 0758 71D2 0000 0758 71D2 0000 


B3(5): 0450 63E4 0000 0450 63E4 0000 
— 


i 


00E4 0000 
FFFF D854 | 


[o0E3 D854] 










NX 
5 | 





Storage — Before and After 





0/8 





2/A 4/C 
21 


0758 71D2 0100 





0013 D854 
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COMPUTE ADDRESS LONG HALFWORD 
IMMEDIATE (CALHI) 


Instruction Description 


The second operand (I,) is used as a signed 
displacement to be added to the address value in the 
base register identified by the third operand; the 
resultant address is placed in the base register identified 
by the first operand. 


Format: RI 
sc jeje) 
O Bits 8 12 16 31 


Operation: The displacement value is a 16-bit signed 
integer. The sign bit is propagated through the third and 
fourth (left) offset bytes, and a 4-byte signed binary add 
is performed. 


The address computation is performed as follows. The 
rightmost 3 bytes (segment group offset) of the address 
value (1) identified by the third operand are logically 
padded on the left with 1 byte of zeros, creating a 
positive 4-byte binary integer. The displacement 
identified by the second operand (2) is then added to 
this value following the rules of signed arithmetic. The 
result of this calculation (3) must satisfy the following 
validity checks: 


« Must not be greater than a value of 16 megabytes 
less 1 (hex FF FFFF or decimal 16 777 215). 


« Must be a positive result. 


e Must not be less than the value of the space locator 
offset, 3-byte logical binary field in storage located at 
the address (4) determined by concatenating hex OO 
001D on the right of the leftmost 3 bytes of the 
third-operand address value. 
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If any of the above checks fail, an invalid segment group 
address exception occurs and the operation is 
suppressed. Otherwise, the rightmost 3 bytes of the 
calculated result are concatenated on the right with the 
leftmost 3 bytes of the third-operand address value 
(segment group identifier) forming the resultant address 
(5). No storage reference is made using the resultant 
address placed in the first operand, so that the address 
is not inspected for addressing exceptions. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must start 
on a halfword boundary; otherwise, a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 
— Address translation 


— Addressing 
— Invalid segment group address 


2 





C 


CALHI Example 
Op |B, l, 
5C 8 D854 
QO Bits 8 12 16 31 


Assembler: CALHI B,, B3, Iz 
Machine: 5C85 D854 


Before 





B, (8): xxxx xxxx xxxx 0450 63E3 D854 







B3(5): 0450 63E4 0000 0450 63E4 0000 


00E4 0000 
FFFF D854] 


QOE3 D854 





Storage — Before and After 


0450 6300 001D 
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COMPUTE LONG FLOAT MATH FUNCTION USING 
ONE INPUT VALUE (CLFMF1) 


Instruction Description 


The operation is performed by computing the 
mathematical function according to the controls 
(operand 3). The source (operand 2) is used as the 
argument, and the result is placed into the receiver 
(operand 1). The computation is always done in 
floating-point. 


Format: SS 


fele| oo |e) o 
8 12 


0 Bits 16 20 32 36 47 


Operation: The first and second operands occupy 8 
bytes each, and have the long floating-point field 
format. 


The third operand, halfword register hex F, contains 
control information that indicates the mathematical 
function to be performed. The meaning of the 2-byte 
control information is: 


Hex Value Meaning 

0001 Sine 

0003 Cosine 

0005 Tangent 

0006 Arc tangent 

0010 Exponential function 

0011 Natural logarithm (base e) 
0020 Square root 


All other values are reserved 
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e Sine (hex 0001). The sine of the numeric value of the 


source operand, whose value is considered to be in > 
radians, is computed and placed in the receiver 
operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


The result is in the range -1 < SIN(x) < 1. 


Cosine (hex 0003). The cosine of the numeric value 
of the source operand, whose value is considered to 
be in radians, is computed and placed in the receiver 
operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


The result is in the range -1 < COS(x) < 1. 


Tangent (hex 0005). The tangent of the source 
operand, whose value is considered to be in radians, 
is computed, and the result is placed in the receiver 
operand. 


If the source operand is a value of infinity, a ; 
floating-point invalid operand exception is signaled. ) 


Arc Tangent (hex 0006). The arc tangent of the 
source operand is computed, and the result (in 


radians) is placed in the receiver operand. 


lf the source operand is a value of positive infinity in 
affine mode, the result is +pi/2. 


If the source operand is a value of negative infinity in 
affine mode, the result is -pi/2. 


The result is in the range -pi/2 < ATAN(x) < pi/2. 


» Exponential Function (hex 0010). The value e is raised Sign Code: Not applicable. 
to the power specified in the source operand, and the 
result is placed in the receiver operand. 
Condition Code: Not changed. 
If the source operand is a value of positive infinity in 
affine mode, the result is positive infinity. If the 
source operand is a value of negative infinity in affine Carry: Not applicable. 
mode, the result is positive O. 


e Natural Logarithm (base e) (hex 0011). The natural Boundary Requirements: None. 
logarithm of the source operand is computed, and the 
result is placed in the receiver operand. 
Program Exceptions: 
If the source operand is a value of O, the result is 


negative infinity. — Address translation 
— Addressing 
¢ Square Root (hex 0020). The square root of the — Effective address overflow 
numeric value of the source operand is computed and — Floating-point invalid operand 
placed in the receiver operand. — Floating-point overflow 
— Floating-point underflow 
If the source operand has a value of negative O, the — Specification 


result is negative 0. Any attempt to form the square 
root of any other negative value causes a 
floating-point invalid operation exception to be 
signaled. 


The square root of positive infinity is positive infinity. 


The result is accurate to the least significant bit. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 
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CLFMF1 Example 


Op 01 D, 
CE 040 048 


0 Bits 8 12 16 20 32 36 47 
Assembler: CLFMF1 D, (B,), Dz (Bz) 

Machine: CEOE 2040 2048 

B,(2) and B,(2): 800D OCOO 0000 

R(F): 0020 


Storage — Before 


0/8 2/A 
800D OCOO 0040 XXXX XXXX 
800D OCOO 0048 4000 00o00 





Storage — After 

0/8 2/A 
800D OCOO 0040 3FF6 AOQ9E 
800D OCOO 0048 4000 0000 
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COMPUTE LONG FLOAT MATH FUNCTION USING 
TWO INPUT VALUES (CLFMF2) 


Instruction Description 


The operation is performed by computing the 
mathematical function specified in the controls (operand 
4). The two source values (one is operand 2 and the 
other is addressed by operand 3) are used as arguments 
and the result is placed into the receiver (operand 1). 
The computation is always done in floating-point. 


Format: SS 


ele} oo, [el o 


0 Bits 8 12 16 20 32 36 47 


Operation: The first and second operands, and the data 
addressed by operand 3, each occupy 8 bytes and have 
the long floating-point field format. 


Operand 3, bits 8 through 11, specifies a base register 
that contains the address of the second souce operand. 


The fourth operand, halfword register hex F, contains 
control information that indicates the mathematical 
function to be performed. The meaning of the 2-byte 
control information is: 


Hex Value Meaning 


0001 Power (X to the Y) 


All other values 
are reserved 


« Power (X to the Y) (hex 0001). The computation X 
power Y, where X is the first source operand 
(operand 2) and Y is the second (operand 3), is 
performed, and the result is placed in the receiver 
operand (operand 1). 


For each combination of the two source values that 
would deliver a complex value as the result, a 
floating-point invalid operand exception is signaled 
(for example, if source 1 (operand 2) is a real number 
less than O and source 2 (operand 3) is 1/2). 


Some special cases in affine mode are: 


Infinity +Infinity Invalid 






operation 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large 
to be represented in the result format. See 
Floating-Point Overflow Exception in Chapter 6 for 
further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 
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CLFMF2 Example ) 


CE 040 
12 


O Bits 8 16 20 32 36 47 
Assembler: CLFMF2 D, (B,), D,(B), B3 

Machine: CEEF 2040 2050 

B, (2) and B,(2): 800D OCO0 0000 

B,(E): 800D OC00 0300 

R(F): 0001 


Storage — Before 


800D OCOO 0040 
800D OCOO 0050 
800D OCOO 0300 





Storage — After | ) 


800D OCOO 0040 
800D OCOO 0050 
800D O0COO 0300 
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COMPUTE SHORT FLOAT MATH FUNCTION USING 
ONE INPUT VALUE (CSFMF1) 


Instruction Description 


The operation is performed by computing the 
mathematical function according to the controls 
(operand 3). The source (operand 2) is used as the 
argument, and the result is placed into the receiver 
(operand 1). The computation is always done in 
floating-point. 


Format: SS 


ele! o [el 


0 Bitt 8 12 16 20 32 36 47 


Operation: The first and second operands occupy 4 
bytes each and have the short floating-point field 
format. 


The third operand, halfword register hex F, contains 
control information that indicates the mathematical 
function to be performed. The meaning of the 2-byte 
control information is: 


Hex Value Meaning 

0001 Sine 

0003 Cosine 

0005 Tangent 

0006 Arc tangent 

0010 Exponential function 

0011 Natural logarithm (base e) 
0020 Square root 


All other values are reserved 
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Sine (hex 0001). The sine of the numeric value of the 
source operand, whose value is considered to be in 
radians, is computed and placed in the receiver 
operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


The result is in the range -1 < SIN(X) < 1. 


Cosine (hex 0003). The cosine of the numeric value 
of the source operand, whose value is considered to 
be in radians, is computed and placed in the receiver 
operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 
The result is in the range -1 < COS(c) < 1. 


Tangent (hex 0005). The tangent of the source 
operand, whose value is considered to be in radians, 
is computed, and the result is placed in the receiver 
operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


Arc Tangent (hex 0006). The arc tangent of the 
source operand is computed, and the result (in 
radians) is placed in the receiver operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


The result is in the range -pi/2 < ATAN(x) < pi/2. 
Exponential Function (hex 0010). The value e is raised 
to the power specified in the source operand, and the 


result is placed in the receiver operand. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


2 





C 


e Natural Logarithm (base e) (hex 0011). The natural 
logarithm of the source operand is computed, and the 
result is placed in the receiver operand. 


If the source operand is a value of O or less than O, a 
specification exception is signaled. 


If the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 


e Square Root (hex 0020). The square root of the 
numeric value of the source operand is computed and 
placed in the receiver operand. 


lf the source operand has a value of negative O, the 
result is negative 0. Any attempt to form the square 
root of any other negative value causes a 
specification exception to be signaled. 


lf the source operand is a value of infinity, a 
floating-point invalid operand exception is signaled. 
The result is accurate to the least significant bit. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large 
to be represented in the result format. See 
Floating-Point Overflow Exception in Chapter 6 for 
further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
Addressing 

Effective address overflow 
Floating-point invalid operand 
Floating-point overflow 
Floating-point underflow 
Specification 


CSFMF1 Example 
Op D, D, 
AE 058 O5C 
QO Bits 8 12 16 20 32 36 47 
Assembler: CSFMF1 D, (B,), D (B,) 
Machine: AEOE 2058 205C 
B,(2) and B,(2): 800D OCOO 0000 
R(F): 0020 


Storage — Before 


800D OC00 0058 
800D OCOO O05C 





Storage — After 

0/8 2/A 

8000 OCOO 0058 3FB5 O4F3 
8000 OCOO 005C 
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COMPUTE SHORT FLOAT MATH FUNCTION USING 
TWO INPUT VALUES (CSFMF2) 


Instruction Description 


The operation is performed by computing the 
mathematical function specified in the controls (operand 
4). The two source values (one is operand 2 and the 
other is addressed by operand 3) are used as 
arguments, and the result is placed into the receiver 
(operand 1). The computation is always done in 
floating-point. 


Format: SS 


ele} oo lel 
8 12 


O Bits 16 20 32 36 47 


Operation: The first and second operands, and the data 
addressed by operand 3, each occupy 4 bytes and have 
the short floating-point field format. 


Operand 3, bits 8 through 11, specifies a base register 
that contains the address of the second source operand. 


The fourth operand, halfword register hex F, contains 
control information that indicates the mathematical 
function to be performed. The meaning of the 2-byte 
control information is: 


Hex 
Value Meaning 
0001 Power (X to the Y) 


All other values are reserved 
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« (Power (X to the Y) (hex 0001). The computation X 
power Y, where X is the first source operand 
(operand 2) and Y is the second (operand 3), is 
performed, and the result is placed in the receiver 
operand (operand 1). 


For each combination of the two source values that 
would deliver a complex value as the result, a 
specification exception is signaled (for example, if 
source 1 (operand 2) is a real number less than O and 
source 2 (operand 3) is 1/2). 


If both source operands have a value of 0, a 
specification exception is signaled. 


If either of the source operands is a value of infinity, 
a floating-point invalid operand exception is signaled. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large 
to be represented in the result format. See 
Floating-Point Overflow Exception in Chapter 6 for 
further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point invalid operand 


— Floating-point overflow 
— Floating-point underflow 


— Specification 





CSFMF2 Example 
Panna ae: 

AE 2 060 
0 Bits 16 20 32 36 47 
Assembler: CSFMF2 D, (B,), D,(B,), B3 
Machine: AEEF 2058 2060 
B, (2) and B,(2): 800D OCOO 0000 
B3(E): 800D OCOO 0300 
R(F): 0001 

Storage — Before 

800D OCOO 0058 


800D OCOO 0060 
800D OCO0 0300 





Storage — After 


800D OCO00 0058 
800D OCOO 0060 
800D OCOO 0300 
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COMPUTE SUBSCRIPT ADDRESS (CSA) 
Instruction Description 


The value of the second operand in storage is reduced 
by one and multiplied by |,. The product of this 
multiplication is added to the first operand, and the sum 
is placed in the first-operand register. 


Format: SI 
ao [efole| o | 4 
O Bits 8 12 16 20 32 47 


Operation: The second operand is unchanged by the 
operation. If the second or third operand is zero, a 
specification exception is raised and the operation is 
suppressed. 


The first operand is treated as a virtual address. The 
second and third operands are treated as 16-bit 
unsigned binary integers. The second operand, which 
occupies 2 bytes in storage, is reduced by a value of 1 
and multiplied by the contents of the |, field from the 
instruction. This product, which is considered to be a 
24-bit unsigned binary integer, is then added to the 
contents of the base register designated by B,, and the 
sum replaces the contents of the register. 


Overflow: If a carry occurs from bit 24 to bit 23 as a 
result of either the multiply or the add operation, an 

effective address overflow exception occurs and the 

operation is suppressed. 


Sign Code: Not applicable. 


Condition Code: Not changed. 
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Carry: Not applicable. 


Boundary Requirements: The second operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


CSA Example 

Op |B, I, 

AD 7 0050 
O Bits 8 12 16 20 32 47 
Assembler: CSA B,, D,(B2), I3 
Machine: AD70 3410 0050 
B2(3): 6A39 8357 BOOO 

Before After 


B, (7): 5328 C102 03B0 5328 C102 D5B0 


Storage — Before and After 


6A39 8357 B410 





(02A1—1) (0050) + 5328 C102 03B0 = 5328 C102 D5BO 


This page is intentionally left blank. 
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COMPUTE SUBSCRIPT ADDRESS CONSTRAINED 
(CSAC) 


Instruction Description 


The value of the third operand in storage is validated, 
reduced by one, and multiplied by the halfword found in 
bytes 4-5 of the second storage operand. The product 
of this multiplication is added to the fourth operand and 
the sum is placed in the first-operand register. 


Format: SS 


8 12 


0 Bits 16 20 32 36 47 


Operation: The second, third, and fourth operands are 
unchanged by the operation. If the second-operand 
bytes 0-3, the second-operand bytes 4-5, or the third 
operand contains zero values, a specification exception 
is recogriized and the operation is suppressed. 


The fourth operand is treated as a 6-byte virtual 
address. The third operand is a 32-bit logical value. If it 
and the 6-byte second-operand field are not fullword 
aligned, a specification exception is recognized and the 
operation is suppressed. The third-operand value is 
validated as being nonzero, but less than hex 0100 0000 
(that is, the high-order byte must be zero) and less than 
or equal to the limit value found in bytes 0-3 (a 32-bit 
logical value) of the second operand. If found to be 
outside this range, a specification exception is 
recognized and the operation is suppressed. If valid, the 
third operand is reduced by a value of one and 
multiplied by the logical value found in bytes 4-5 of the 
second operand. This product is a 32-bit logical value 
with an absolute value of less than hex 0100 0000; 
otherwise, an invalid segment group address exception 
is recognized and the operation is suppressed. The 
product is added to the base register designated by the 
fourth operand, and the result is placed into the 
first-operand base register. 
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Overflow and Sign Code: Not applicable. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: \|f a carry occurs from the 3-byte offset as 4 
result of the add operation, an invalid segment group 
address exception occurs and the operation is 
suppressed. 


Boundary Requirements: The second and third operands 
must be fullword aligned. If not, a specification 
exception is recognized and the operation is suppressed. 





Program Exceptions: 


Address translation 

Addressing 

Effective address overflow 

Invalid segment group!tf —Specification 


CSAC Example 


Op 
BF 
12 


0 Bits 8 16 20 32 36 47 
Assembler: CSAC B,, D,(B,),D3(B3), Ba 
Machine: BF65 4100 3200 
Before After 
B(3): 0001 2345 0000 0001 2345 0000 
B(4): 0001 2345 0000 0001 2345 0000 
B(5): 999999555555 9999 9955 5555 
B(6): 6666 6666 6666 9999 9955 7777 


Main storage is unchanged by the operation. 


Storage - Before and After 


0/8 2/A 4/C 
0001 23450100 | 0034 5678 0002 
0001 23450200 | OOOO 1112 = xxxx 





6/E 
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COMPUTE SUBSCRIPT ADDRESS CONSTRAINED 
HALFWORD (CSACH) 


Instruction Description 


The value of the third operand in storage is validated, 
reduced by one, and multiplied by the halfword found in 
bytes 4-5 of the second storage-operand. The product 
of this multiplication is added to the fourth operand and 
the sum is placed in the first-operand register. 


Format: SS 


ete) o, |e) 
8 12 


0 Bits 16 20 32 36 47 


Operation: The second, third, and fourth operands are 
unchanged by the operation. If the second-operand 
bytes 0-3, the second-operand bytes 4-5, or third 
operand contains zero values, a specification exception 
is recognized and the operation is suppressed. 


The fourth operand is treated as a 6-byte virtual 
address. The third operand is a 16-bit logical value. If 
the third-operand field is not halfword aligned, or the 
second operand fullword aligned, a specification 
exception is recognized and the operation is suppressed. 
The third-operand value is validated as being nonzero, 
but less than hex 8000 (that is, the high-order bit must 
be zero) and less than or equal to the limit value found 
in bytes 0-3 (a 32-bit logical value) of the second 
operand. If found to be outside this range, a 
specification exception is recognized and the operation 
is suppressed. lf valid, the third operand is reduced by a 
value of one and multiplied by the logical value found in 
bytes 4-5 of the second operand. This product is a 
32-bit logical value with an absolute value of less than 
hex 0100 0000; otherwise, an invalid segment group 
address exception is recognized and the operation is 
suppressed. The product is added to the base register 
designated by the fourth operand and the result is 
placed into the first-operand base register. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: \f acarry occurs from the 3-byte offset of the 
fourth operand as a result of the add operation, an 
invalid segment group exception is recognized and the 
operation is suppressed. 


Boundary Requirements: The third operand must be 
halfword aligned and the second operand 6-byte field 
fullword aligned. If not, a specification exception is 
recognized and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Invalid segment group 
Specification 


CSACH Example 


Op 
AF 
12 


O Bits 


8 16 20 32 36 47 


Assembler: CSACH B,,D,(B,),D3(B3), Ba 


Machine: AF65 4100 3200 


B(3): 
B(4): 
B(5): 


B(6): 


Before After 


0001 2345 0000 0001 2345 0000 


~ 0001 2345 0000 0001 2345 0000 


9999 9955 5555 + 9999 9955 5555 


6666 6666 6666 9999 9955 7777 


Storage — Before and After 









0/8 2/A 4/C 
0034 5678 0002 


1112 XXXX XXXX 


6/E 








0001 2345 0100: 
0001 2345 0200 
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CONVERT BINARY TO LONG FLOAT (CVBLF) 


Instruction Description 


The value of the second operand is converted from 
binary to floating point, and the result is placed in the 
first operand location. 


Format: SS 
Lee lulls] o, [e]_o, _ 
O Bits 16 20 32 36 47 


Operation: The first operand (receiver) occupies 8 bytes 
of storage in order to accomodate the long 
floating-point format. 


The second operand (source) occupies either 4 or 8 
bytes. The length (4 or 8 bytes) is specified by the 

length operand (bits 8 through 11) in the instruction. 
The length operand has the following format: 


Bits Meaning 

8 Reserved 

9-11 Length of source 
011 = 4 bytes 
111 = 8 bytes 


All other values are invalid 


The second operand contents is treated as a 
right-aligned, signed binary integer value (whole number 
rather than a fraction) with an assumed binary point to 
the right of its rightmost digit. 


The result of the operation is a normalized floating-point 
number, rounded, if necessary, according to the 
rounding mode specified in the task dispatching 
element. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


Sign Code: Not applicable. 
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Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Operand 1 data must be 
fullword aligned; otherwise, a specification exception 
occurs, and the operation is suppressed. The result 
obtained from overlapping operands is unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
— Floating-point inexact result 
Specification 


CVBLF Example 
Op D, 
CE 060 
OQ Bits 16 20 32 36 47 
Assembler: CVBLF D, (B,), D,(L,B,) 
Machine: CE79 4050 4060 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 

0/8 2/A 

0010 0200 0050 XXXX  XXXX 
0010 0200 0060 0000 0000 





Storage — After 


0/8 2/A 
0010 0200 0050 406F E000 
0010 0200 0060 0000 0000 





Condition Code: Not changed. 


CONVERT BINARY TO PACKED (CVBP) 
Instruction Description 
The radix of the second operand is changed from binary 


to decimal, and the result is placed in the first-operand 
location. 


Format: SS 
O Bits 12 16 20 32 36 47 


Operation: The number is treated as a right-aligned, 
binary value both before and after conversion. 


The second operand is a 32-bit, signed, binary integer 
occupying a word in storage. The first operand occupies 
8 bytes in storage and is formed using the packed 
decimal format with the rightmost 4 bits representing 
the sign. 


Overflow: Not applicable. 


Sign Code: The preferred signs are used for the result 
as follows: a positive sign is encoded as 1111 (hex F); a 
negative sign is encoded as 1101 (hex D). 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Both operands must begin on a 
word boundary; otherwise a specification exception 
occurs and the operation is suppressed. The operands 
can overlap in storage. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


CVBP Example 


Op 
F8 


0 Bits 12 16 20 32 36 47 


Assembler: CVBP D, (B,), D> (B2) 
Machine: F800 3210 3320 
B, (3) and B,(3): 0310 0004 AQ00O 


Storage — Before 
i 


0/8 2/A 
0310 0004 A210 XXXX XXXX 
0310 0004 A320 0021 3FA4 





Storage — After 


0/8 2/A 
0310 0004 A210 0000 0000 
0310 0004 A320 | 9021 3FA4 
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Instruction Descriptions 


CONVERT BINARY TO SHORT FLOAT (CVBSF) 


Instruction Description 


The value of the second operand is converted from 
binary to floating point, and the result is placed in the 
first operand location. 


Format: SS 
Lee [uie|s| o |e o, _ 
O Bits 12 16 20 32 36 47 


Operation: The first operand (receiver) occupies 4 bytes 
of storage in order to accomodate the short 
floating-point format. 


The second operand (source) occupies either 4 or 8 
bytes. The length (4 or 8 bytes) is specified by the 

length operand (bits 8 through 11) in the instruction. 
The length operand has the following format: 


Bits Meaning 

8 Reserved 

9-11 Length of source 
011 = 4 bytes 
111 = 8 bytes 


All other values are invalid 


The second operand contents is treated as a 
right-aligned, signed binary integer value (whole number 
rather than a fraction) with an assumed binary point to 
the right of its rightmost digit. 


The result of the operation is a normalized floating-point 
number, rounded, if necessary, according to the 
rounding mode specified in the task dispatching 
element. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


Sign Code: Not applicable. 
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Condition Code: Not changed. ) | 


Carry: Not applicable. 


Boundary Requirements: Operand 1 data must be 
fullword aligned; otherwise, a specification exception 
occurs, and the operation is suppressed. The result 
obtained from overlapping operands is un,’ edictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Floating-point inexact result 
Specification 


CVBSF Example 
Op D, 
AE O60 
O Bits 12 16 20 32 36 47 
Assembler: CVBSF D, (B,), D2 (L2Bz) J 
Machine: AE39 4050 4060 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 


0/8 2/A 


‘0010 0200 0050 XXXX XXXX 


0010 0200 0060 OOFF 0000 





Storage — After 


0/8 2/A 
0010 0200 0050 4B7F 0000 
0010 0200 0060 OOFF 0000 





Condition Code: Not changed. 


CONVERT CHARACTER TO SNA (CVTCS) 


Instruction Description 


The operation converts the data at the second operand 
location from character to SNA (systems network 
architecture) compressed format. The conversion is 
controlled by information whose address is in the base 
register specified in the third operand. The result is 
placed in the first operand. 


The operands are as follows: 


Operand Description 


1 The base and displacement for the 
starting address of the result string 
that is to contain the converted data. 


2 The base and displacement for the 
starting address of the source string 
that contains the data to be 
converted. 


3 The base register that contains the 
address of the control information for 
the conversion operation to be 
performed. 


4 Halfword register 14 specifies the 
length of the first operand (result 
string). A length of zero causes a 
specification exception. 


5 Halfword register 15 specifies the 
length of the second operand (source 
string). A length of zero causes a 
specification exception. 


The source operand (2) contains one or more 
fixed-length data fields that may be separated by 
fixed-length gaps of characters to be ignored during the 
conversion. The source operand is described by the 
controls operand (3), which also specifies the number of 
bytes of data from the source to be processed to 
produce a converted record in the result string. The 
source record length does not need to be the same as 
the source data field length. 


Instruction Descriptions 
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The following diagram explains this structure for the 
source operand: 


Actual Source Operand Bytes 2 


Data Field Gap Data Field Gap Data Field Gap 


Data Processed as Source Records 


5 ord re Record Record 


For example, notice that the record length is less than 
the data field length and some records may have 
gaps in the middle. 


The controls operand is a 15-byte string that specifies 
additional information to be used to control the 
conversion. The controls operand has the following 
format: 


Source Record Unconverted 
Moa- 


Result Offset | Source Offset | Data Field Gap Offset Gap Length | Separator | Compression! Source Record 


ifier 
Length Character | Character Bytes 





Initially, the source offset and the result offset fields 


Bytes Description j ea 
"= P specify which byte of the source field is to be processed 
0-1 Offset into the result operand next, and where the next byte of the result shoud be 
entered in the result field. The source and result offset 
2-3 Offset into the source operand fields are set to values that indicate how much of the 
ae conversion is complete when the instruction is 
4 Modifier ; atts 
interrupted or complete. An initial offset beyond the end 
5 Source record length (>0 if record of the related source or result operand causes a 
processing is specified) specification exception. 
6-7 Data field length 
8-9 Offset to the next gap in the source 
operand 


10-11 Gap length 


12 Record separator character 
13 Prime compression character 
14 Unconverted source record bytes 


10-104 


C 


The modifier has the following valid values: 


Bit(s) Meaning 


0 Compression 
0 = Do not perform compression 
1 = Perform full compression 
1-2 Processing Mode 
00 = String processing. Do not 


use record separators; do not 
do blank truncation; do not 
perform data transparency 
conversion. 


01 
10 


Reserved 


Record processing. Use 
record separators and do 
blank truncation; do not 
perform data transparency 
conversion. 


11 = Record processing. Use 
record separators, do blank 
truncation, and perform data 
transparency conversion. 


3 Do not perform record Spanning 


O= Do not perform record 
spanning. 


1 = Perform record spanning 
(allowed only if bit 1 = 1). 


4-7 Reserved. Must be zero. 


Note: An invalid modifier value causes a specification 
exception. 


The source record length specifies the number of bytes 
to be processed to produce a converted record in the 
result operand. If record processing a source record 
length of zero results in a specification exception. Data 
fields in the source may be separated by gaps of 
characters. These gaps are ignored during conversion. 


The source data field length specifies the number of 
bytes in the source data fields. Specifying a data field 
length of zero indicates the source length is one data 
field; in this case, the gap length and gap offset are 
ignored. 


The following diagrams illustrate the makeup of the 
source and result operands. 


Source Operand 


Ltt I 


_Data Field |Gap 
~ Length oe | 


Gap 
Offset 


Current Byte to be Processed 
Record Boundary 


Start of Source 





Source Length 


The gap offset specifies the offset (relative to the source 
offset) to the beginning of the next gap in the source. 
Gap offset is updated when the instruction is 
terminated. It is not used as input if the source data 
field length is specified as zero. It may be modified 
during execution of the instruction. 


The gap length specifies the number of bytes (hex) of 
data between data fields in the source operand. This 
length is ignored if the data field length is specified with 
a value of zero. The gap length starts with a value of O. 


The record separator character field specifies the value 
that is to precede the converted form of each record in 
the result operand. This value also serves as a delimiter 
for the prior record when trailing blanks are truncated; 
the last record will not have this delimiter. The record 
separator character field can have any hexadecimal 
value. However, the Convert SNA to Characters 
instruction recognizes only values less than hex 40 as 
record separators. 


This field is ignored if string processing is specified in 
the modifier. 
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Result Operand 


Result 


ne —_ Separator Character (may 


Offset not be first character stored) 





Start of Result 


Result Length 





The prime compression character specifies the value to 
be used as the prime compression character. It can be 
any value. It is ignored if compression is not specified 
in the algorithm modifier. 


The unconverted source record bytes contains a count of 
the residual, unconverted bytes in the current source 
record. This parameter is not used as input if record 
spanning is not specified in the algorithm modifier. The 
count may be set to zero during execution of the 
instruction. 


Format: SS 


8 


0 Bits 12 16 20 32 36 47 


Operation: The operation begins by accessing the bytes 
of the source operand at the location specified by the 
source offset. This location is assumed to be the start 
of a record. Gaps between data fields are ignored, 
causing the access of data bytes to occur as if the data 
fields were contiguous with one another. 


Accessed bytes are considered to be a source record for 
the conversion. They are converted according to the 
following modes and optional functions and then stored 
in the result. 
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String Processing Mode } 
String processing occurs when bit 1 of the algorithm 

modifier is equal to zero. The bytes accessed in the 
source are converted, compressed, and then stored in 
the result. 


Compression 


The compression function is always performed in string 
processing mode. Compression reduces the length of 
duplicate character strings in the source data. 


Compressed data is built by concatenating one or more 
compression strings together to describe the converted 
record. The bytes of the converted source data are 
checked in order to locate the: 


« Prime compression character strings (two or more 
consecutive prime compression characters) 


« Duplicate character strings (three or more duplicate 
nonprime characters) 


¢« Nonduplicate character strings occurring in the 
source. J 

The character strings encountered (prime, duplicate, and 

non-duplicate) are reflected in the compressed data by 

building one or more compression strings to describe 

them. Compression strings are comprised of a string 

control byte (SCB), followed by prescribed bytes of data 

related to the character string being described. 





C 


The SCB has the following format and bit definitions: 


Bits 


0-1 


2-7 


Meaning 


Control 


00 = 


01 
10 


11 


Count 


n nonduplicate characters are 
between this SCB and the 
next one. n is the value in 
the count field; possible 
values are 1-63 (decimal). 


Reserved 


This SCB represents n 
deleted prime compression 
characters. n is the value in 
the count field; possible 
values are 2-63 (decimal). 
The next byte is the next 
SCB. 


This SCB represents n 
deleted duplicate characters. 
n is the value of the count 
field; possible values are 


3-63 (decimal). The next 


byte contains a specimen of 
the deleted characters. The 
byte following the specimen 
character contains the next 

SCB. 


The value n (in binary) in this field 
represents the count of the number of 
characters that have been deleted for a 
prime compression character string, a 
duplicate character string, or the number 
of characters to the next SCB for a 
nonduplicate character string. A count 
value of 0 cannot be produced. 


In string processing mode: 


e Compression is performed on the entire source 
operand on a string basis. The fields in the controls 
operand related to record processing are ignored. 


e If the compressed data cannot be completely 
contained in the receiver, the instruction ends with 
a receiver overrun condition code. 

— As much of the compressed data as will fit is 
placed into the receiver, and the controls operand 
is updated to describe how much of the source 
data was successfully converted into the receiver. 

— The last compression entry placed into the receiver 
may be adjusted, if necessary, to a length which 
fits in the receiver. This length adjustment applies 
only to compression entries for non-duplicate 
strings. 

— Compression entries for duplicate strings are only 
placed in the receiver if they fit with no 
adjustment. By doing this, no more than 1 byte of 
unused space will remain in the receiver; its value 
is unpredictable. 


e lf the compressed data can be completely contained 
in the receiver, the instruction ends with a source 
exhausted condition code. The compressed data is 
placed into the receiver, and the controls operand is 
updated to indicate that all of the source data was 
successfully converted into the receiver. 
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Record Processing Mode 


Record processing occurs when bit 1 of the algorithm 
modifier is equal to 1. 


The source offset locates either the start of a full or the 
start of a partial record. If record spanning is not 
specified, source offset locates a full record. If record 
spanning is specified, the source offset is assumed to 
locate a point at which processing of a partially 
converted record is to be resumed (this could actually be 
the start of a full record). The unconverted source 
record bytes value (which could be QO) gives the length of 
the remaining portion of the source record to be 
converted. The conversion process is started by 
completing the conversion of the current source record 
(if such is the case), before processing the next full 
source record. 


When the conversion process for a record is complete 
(including trailing blank truncation, data transparency 
conversion (if specified), and compression (if specified)) 
and a receiver overrun has not occurred, the process is 
started for the next record. 


A check for end of source is made at the start of 
conversion for each record. If the source does not 
contain a full record, the source exhausted condition is 
recognized and the instruction is terminated. Conversion 
of a partial source record is not performed. 


Trailing Blank Truncation 


The trailing blank truncation function is always 
performed in record processing mode. This function can 
be performed with, or without, the optional transparency 
conversion and compression functions. 


A truncated record is built by logically appending the 
record data to the record separator (a value specified in 
the controls operand) and removing all blank characters 
after the last nonblank character. If a record has no 
trailing blanks, then no actual truncation takes place. A 
null record (a record consisting entirely of blanks), will 
be converted as just the record separator character with 
no other data following it. The truncated records, then, 
consist of the record separator character followed by the 
full record data, the truncated record data, or no data. 
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If the truncated record cannot be completely contained 
in the receiver, the instruction ends with a receiver 
overrun condition code. If record spanning is specified, 
as much of the truncated record as will fit is stored into 
the receiver, and the controls operand is updated to 
describe how much of the source record was 
successfully converted. If record spanning is not 
specified, the controls operand is updated to describe 
only the last fully converted record; the values of the 
remaining bytes in the receiver are unpredictable. 


Data Transparency Conversion 


The data transparency conversion function is performed 
in record processing mode only. It is optional, not 
mandatory; compression may also be done, but is not 
required. 


This function makes the data in a record transparent to 
the Convert SNA to Character instruction in the area of 
its scanning for record separator values. 


A transparent record is built by placing 2 bytes of 
transparency control information after the record 
separator, but before the actual data. The first byte has 
a fixed value of hex 35 and is referred to as the TRN 
(transparency) control character. The second byte is a 
1-byte hexadecimal count (with allowable values of 
1-255 decimal) of the number of transparent data bytes 
that follow and is referred to as the TRN count. This 
count contains the length of the data (before 
compression) and does not include these TRN control 
information bytes, the record separator, or trailing blanks 
that have been truncated. 


2 


For a null record, no TRN control information is placed 
after the record separator as there is no record data to 
be made transparent. 


If the transparent record cannot be completely contained 
in the receiver, the instruction ends with a receiver 
overrun condition code. 


e lf record spanning is specified, as much of the 
transparent record as will fit is placed in the receiver 
and the controls operand is updated to describe how 
much of the source record was converted. The TRN 
count is adjusted to describe the length of the 
successfully converted data; thus, the transparent 
data for the record is not spanned out of the receiver. 
The remaining bytes of the transparent record, if any, 
will be processed as a partial source record on the 
next invocation of the instruction and will be 
preceded by the appropriate TRN control information. 


For the special case where only 1 to 3 bytes are 
available at the end of the receiver (not enough room 
for the record separator, the transparency control, 
and a byte of data), just the record separator is 
placed in the receiver for the record being converted. 
This can cause up to 2 bytes of unused space at the 
end of the receiver; the values of these unused bytes 
are unpredictable. 


¢ \f record spanning is not specified, the controls 
operand is updated to describe only the last fully 
converted record in the receiver. The values of the 
remaining bytes in the receiver are unpredictable. 


Compression 


The compression function is performed on the converted 
form of the current source record, including the record 
separator character; this can be a truncated record or a 
transparent truncated record. TRN control information 
bytes are always treated as part of a non-duplicate 
compression entry to provide for length adjustment of 
the TRN count, if necessary. 


If the compressed record cannot be completely 
contained in the receiver, the instruction ends with a 
receiver overrun condition code. 


When record spanning is specified: 


e As much of the compressed record as will fit is 
placed into the receiver and the controls operand is 
updated to describe how much of the source record 
was successfully converted into the receiver. 


e The last compression entry placed into the receiver 
may be adjusted, if necessary, to a length that fits in 
the receiver. This applies only to nonduplicate 
strings. 


e Compression entries for duplicate strings are placed 
in the receiver only if they fit with no adjustment. 


e For the special case where data transparency 
conversion is specified, the transparent data being 
described is not spanned out of the receiver; the TRN 
count is adjusted to describe only the amount of data 
successfully placed into the receiver. 


e For the special case where only 2-5 bytes are 
available at the end of the receiver, there may not be 
enough room for the compression entry for the 
nonduplicate string containing the record separator, 
the TRN control, and up to a 2-byte compression 
entry for some of the transparent data. In this case, 
the non-duplicate compression entry is adjusted to 
describe only the record separator. By doing this, no 
more than 3 bytes will remain in the receiver; the 
values of these unused bytes are unpredictable. 
Unconverted source record bytes, if any, will be 
processed as a partial source record on the next 
invocation of the instruction and will be preceded by 
the appropriate TRN control information when 
performing transparency conversion. 


When record spanning is not specified, the controls 
operand is updated to describe only the last full 
converted record in the receiver; the values of the 
remaining unused bytes in the receiver are 
unpredictable. 
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Instruction Termination 
The CVTCS instruction terminates when: 


e The end of the source operand is reached (see note). 
This results in a source exhausted condition code. 


e The end of the receiver is reached (see note). This 
results in a receiver overrun condition code. 


Note: For the special case of a tie between the source 
exhausted and receiver overrun conditions, the source 
exhausted condition is recognized first because when 
source exhausted is the resultant condition, the receiver 
may also be full. In this case, the offset into the 
receiver operand may contain a value equal to the length 
specified for the receiver, which would cause an 
exception to be detected on the next invocation of the 
instruction. The processing performed for the source 
exhausted condition should provide for this case if the 
instruction is to be invoked multiple times with the same 
controls operand value. When the receiver overrun 
condition is the resultant condition, the source will 
always contain data remaining to be converted. 


At the completion of the instruction execution, the 
source and receiver offset parameters are updated to 
point to the next bytes to be operated on in the source 
and receiver, respectively. The source offset may point 
to the start of a gap, but will never point within a gap. 


If record spanning is specified, the unconverted source 
record bytes parameter is updated to specify the number 
of remaining unconverted source record bytes. 


If the source data field length is not O, the gap offset 
parameter is updated to point to the next gap, relative 


to the source offset parameter just updated. 


Any form of overlap between the operands of this 
instruction yields unpredictable results. 
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Programming Notes 3 


If the source operand does not end on a record 
boundary (meaning the last record is spanned out of the 
source), this instruction performs conversion only up to 
the start of that partial record. The user of this 
instruction must move this partial record to combine it 
with the rest of the record in the source operand to 
provide for subsequent correct processing. If full 
records are provided, the instruction performs its 
conversion out to the end of the source operand and no 
special processing is required. 


At the completion of this instruction, any bytes in the 
receiver beyond the location pointed to by the receiver 
offset are unpredictable. 


Although any value of record separator is allowed, use 
of hex 40 can possibly cause some unanticipated 
results. With no transparency, and a completely blank 
record, use of a hex 40 record separator will result in no 
output being stored for that record. This is because the 
record separator is included with the blanks and 
discarded as part of blank truncation. 


This instruction is interruptible. If interrupted, 

information required to continue is stored in the controls J 
operand and the instruction address register will point to | 
the instruction so that processing will Continue after the 

interrupt. 


Overflow and Sign Code: Not applicable. 


Condition Codes 


Source exhausted 
Receiver overrun 


WN — © 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions 


Address translation 


Addressing . 
Effective address overflow 3 


Specification 


C 


CVTCS Example 
Op |B, B, D, 
BE 7 8 AA3 
O Bits 8 12 16 20 32 36 47 
Assembler: CVTCS D, (B,), D, (Bz), B3 
Machine: BE76 8AA3 9541 


B, (8): 0021 A123 0000 (Base register for result) 
B,.(9): 0022 0015 OOOO (Base register for source) 
B3(7): 0100 0303 F105 (Address of control operand) 
R(14): 0005 (Length of result) 

R(15): 0009 (Length of source) 


Storage — Before 


0/8 2/A 
0021 A123 OAA3 XX 


0022 0015 0541 AC 5454 
F1F 1 


0100 0303 F105 
OODO 0300 
0211 ACQ2 





Storage — After 


0/8 2/A 
0021 A123 OAA3 82 


0022 0015 0541 AC 5454 
F1F1 


0100 0303 F105 


O9D0 0300 
0211 ACOdOd 





Before After 
Condition Code: x 0 


instruction Descriptions 
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CONVERT CHARACTERS TO MULTI-LEAVING 
REMOTE JOB ENTRY (CVTCM) 


Instruction Description 


The operation converts the data at the second operand 
location from character to MRJE (MULTI-LEAVING 
Remote Job Entry) format. The conversion is controlled 
by information whose address is in the base register 
specified in the third operand. The result is placed in 


the first operand. 


The operands are as follows: 


Operand 


1 
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Description 


The base and displacement for the 
Starting address of the result string 
that is to contain the converted data. 


The base and displacement for the 
starting address of the source string 
that contains the data to be 
converted. 


The base register that contains the 
address of the control information for 
the conversion operation to be 
performed. 


Halfword register 14 specifies the 
length of the first operand (result 
string). A length of zero causes a 
specification exception. 


Halfword register 15 specifies the 
length of the second operand (source 
string). A length of zero causes a 
specification exception. 


The source operand (2) contains one or more 


fixed-length data fields that may be separated by 
fixed-length gaps of characters to be ignored during the 
conversion. The source operand is described by the 
controls operand (3), which also specifies the number of 
bytes of data from the source to be processed to 
produce a converted record in the result string. The 
source record length does not need to be the same as 
the source data field length. 


J 


C 


The following diagram explains this structure for the 
source operand: 


Actual Source Operand Bytes 


Data Field Gap Data Field Gap Data Field Gap 


Data Processed as Source Records 


foe | meow | meee | 


The controls operand is a 13-byte string that specifies 
additional information to be used to control the 
conversion. The controls operand has the following 
format: 







Source 
Record 
Length 
0 2 Bytes 4 5 6 






Result Source Mod- 
Offset Offset ifier 


Bytes Description 


a — 


Offset into the result operand 

Offset into the source operand 

Modifier 

Source record length (>0) 

Data field length (>0) 

Offset to the next gap in the source operand 
Gap length 

Record control block value 


=e ds sane ls 
oO ~I 


Ne 
om 
anh 


Upon input to the instruction, the result offset and the 
source offset fields specify which bytes of the source 
field are processed and entered into the result field. The 
source and result offset fields are set to values that 
indicate how much of the conversion is complete when 
the instruction is interrupted or complete. An offset 
beyond the end of the related source or result operand 
causes a specification exception. 









Data Field Gap Gap 
Length Offset Length 
8 10 1 


Record Record 












Record 
Control 
Block 
2 





The modifier has the following valid values: 


Value 

(Hex) Description 

00 Perform full compression. 

01 Perform only truncation of trailing blanks. 


Note: An invalid modifier value causes a specification 
exception. 


The source record length specifies the number of bytes 
to be processed to produce a converted record in the 
result operand. A source record length of zero results in 
a specification exception. Data fields in the source may 
be separated by gaps of characters. These gaps are to 
be ignored during conversion. 


The data field length specifies the number of bytes in 
the source data fields. Specifying a data field length of 
zero indicates the source length is one data field; in this 
case, the gap length and gap offset are ignored. 
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The following diagrams illustrate the makeup of the 
source and result operands. 


Source Operand 


Gap 
_ Data Field Gap 
Sais Length Length 
Offset Gap 


Offset 


Current Byte to be Processed 


Record Boundary 


Start of Source 


Source Record Length 


The gap offset specifies the offset to the next gap in the 
source. This offset is both input to and output from the 
instruction. The gap offset decreases as the source 
increases until the gap is reached. The gap offset then 
becomes the offset to the next gap. 


The gap length specifies the number of bytes (hex) of 
data between data fields in the source operand. This 
length is ignored if the data field length is specified with 
a value of zero. The gap length starts with a value of 1. 


The record control block field specifies the value that is 
to precede the converted form of each record in the 
result operand. The record control block field can have 
any hexadecimal value. 


Result Operand 











Roslt_ 
Offset Subrecord Control 
Byte (Hex 80) 
Record Control Byte 


Start of Result 


Result Length 
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Format: SS 


8 12 


0 Bits 16 20 32 36 47 


Operation: The operation begins by accessing the bytes 
of the source operand at the location specified by the 
source offset. This location is assumed to be the start 
of a record. Gaps between data fields are ignored, 
causing the access of data bytes to occur as if the data 
fields were contiguous with one another. 


Accessed bytes are considered to be a source record for 
the conversion. They are converted into the result 
according to the following procedure. 


The record control block value is put into the first byte 
of the result record. A subrecord control block value of 
hex 80 is put into the second byte of the result record. 
If a modifier specifies full compression, then the bytes 
of the source record, as they are accessed in the source, 
are checked for: 


e Blank character strings (2 or more consecutive blanks) 


e Identical character strings (3 or more consecutive 
identical characters) 


e Unidentical character strings 


A blank character string occurring at the end of the 
record is treated as follows. If the record is not 
completely blank, then an end-of-record string control 
bytes (hex 00) is stored in the result. If the entire record 
is blank, then a string control byte indicating 1 blank (a 
nonrepeating character) followed by an.end-of-record 
string control byte is in the result. 


If the modifier specifies blank truncation, then the bytes 
of the source record are checked for a blank character 
string at the end of the source record. If one exists, it is 
treated as a string of trailing blanks. All characters prior 
to a string of trailing blanks in the record are treated as 
one string of unidentical characters. 
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The strings encountered—blank, identical, or 
unidentical-are related in the result of building one or 
more string control bytes to describe them. The format 
of the string control bytes is as follows: 





End of | Com- Number of Characters 
Record | press pelete (Binary) 
0 1 2 3 Bits 8 
Value 
Byte Bit (Binary) 
Q-1 0 0 End of record; the end-of-record string control byte is hex OO. 
1 All other string control bytes. 
1 0 The string is compressed. 
1 The string is not compressed. 
2 If bit 1 = 0. 
0 Blanks have been deleted (hexadecimal 40s). 
1 Nonblank characters have been deleted. 


The. next character in the data stream is the specimen character. 
If bit 1 = 1, this bit is part of the length field for length of uncompressed 


data. 
3-7 00010 If bit 1 = O, this is the number of characters that have been deleted. The | 
11111 value can be from 2 through 31. J 
2-7 000001 - If bit 1 = 1, this is the number of characters before the next string control 
111111 byte (no compression). The uncompressed (unidentical) bytes follow the 


string control bytes in the data stream. The value can be from 1 through 


63. 


When the end-of-source record is encountered, an 
end-of-record string control byte (hex OO) is built into 
the result operand. Trailing blanks in a record, including 
a record of all blanks, are represented in the result by an 
end-of-record character. Additionally, the values in the 
controls operand for the result offset, and source ofset, 
and gap offset are updated. These values describe the 
offsets for the next record to be converted, allowing for 
the interruption of the instruction on a record boundary. 


If the end-of-source record is not encountered, the 
operation continues as described at the beginning of the 
Operation section. 


If the end of source is encountered while processing a 
field, whether or not in conjunction with a record 
boundary, the instruction ends with a condition code of 
zero (source exhausted). See Programming Note. 
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If the converted record cannot be completely contained 
in the result, the instruction ends with a condition code 
of 1 (result overrun). See Programming Note. 


Programming Note: The source offset locates the byte 
following the last source record for which conversion 
was completed. The gap offset indicates the offset to 
the next gap. The gap offset has no meaning and is not 
set when the data field length is zero. The result offset 
locates the byte following the last fully converted record 
in the result. The contents of the remaining bytes in the 
result after the last converted record are unpredictable. 


Any form of overlap between the operands yields 
unpredictable results in the result operand. 


Overflow and Sign Code: Not applicable. 


Storage—Before 


Condition Code: 


0001 O36A 0620 


Q Source used up 
1 Result overrun 
Do ate 

3: as 


0001 1234 0580 


Carry and Boundary Requirements: Not applicable. 0001 5678 OBC5 


Program Exceptions: 


Address translation 
Addressing 

Effective address translation 
Specification 





Storage—After 


Programming Note: If the data field length is zero, the 


gap length and gap offset are ignored. 0001 


036A 0620 


0001 1234 0580 


CVTCM Example 


Op D, 
BE BC5 


O Bit 8 12 16 20 32 36 47 


0001 5678 OBC5 XX 
FO80 A611 
F3E3  C5E2 
8082 A822 


XXXX XX 


Assembler: CVTCM D, (B, ),D, (B, ),B3 


Machine: BE54 4BC5 3582 


OOXX 


B, (4): 0001 5678 0000 
B, (3): 0001 1234 0000 
B3; (5): 0001 036A 0620 
R (14): 0020 
R (15): 0020 


(Base register for result) 
(Base register for source) 
(Address of control operand) 
(Length of result) 

(Length of source) 


Before 
Condition Code: X 
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After 
0 
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CONVERT DECIMAL FORM TO LONG FLOAT 
(CVDFLF) 


Instruction Description 


The decimal form of a floating-point value specified by 
a decimal exponent (operand 2) and a decimal 
significand (operand 3) is converted to binary 
floating-point format, and the result.is placed in the 
binary floating-point field specified by the first operand. 


Format: SS 


ole} oo, |e) 
8 12 


0 Bits 16 20 32 36 4] 


Operation: The first operand specifies a binary 
floating-point field that occupies 8 bytes, and has the 
long floating-point field format. 


The second operand specifies the decimal exponent that 
occupies from 1 through 16 bytes as specified by the 
operand 4 value. This operand has the packed 
fixed-point decimal format. 


The third operand, base register hex E, specifies the 
address of the decimal significand. This operand 
occupies up to 16 bytes of storage as specified by the 
operand 4 value and has the packed fixed-point decimal 
format. 


The fourth operand, halfword register hex F, contains 
the digit lengths of the second and third operands. The 
total number of digits for the exponent (operand 2) is 
contained as a value between 1 and 31 in the leftmost 
byte of the halfword register. The total number of digits 
for the significand (operand 3) is contained as a value 
between 1 and 31 in the rightmost byte of the halfword 
register. The specified digit lengths must be within the 
allowable ranges, or a specification exception is 
signaled. The length of operands 2 and 3 (in bytes) is 
calculated by dividing the total digit count by 2 and 
adding 1 to the resulting quotient. The specified number 
of digits are considered right adjusted in their respective 
fields. An even value digit length indicates the leftmost 
digit position of the packed field is not to be considered 
a digit position of the corresponding operand value. 
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The exponent and significand contain a decimal form of 
a floating-point number. The value of this number is: 2 


Value = M * (10**E) 

where: 
M = the value of the significand operand 
E = the value of the exponent operand 
** denotes exponentiation 
* denotes multiplication 


The exponent is assumed to contain a decimal integer 
value. This signed integer value specifies a power of 10 
that gives the floating-point value its magnitude. It has 
an assumed decimal point immediately to the right of its 
rightmost digit position. 


The significand is assumed to contain a decimal value 
with a leading integer digit in its leftmost digit position 
and fractional digits in the digit positions to the right of 
the integer digit. The signed decimal value specifies the 
decimal digits that give the floating-point value its 
precision. The significand has an assumed decimal point 
immediately to the right of its leftmost digit position. 


The decimal form floating-point value specified by the 
exponent and significand operands is converted to 
binary floating-point format as if to infinite precision. J 
However, the precision provided for in floating-point 
fields is not as great as the precision that can be 
provided for by decimal fields. Long floating-point 
provides for unique representation of a maximum of 15 
significant decimal digits of precision. The significant 
digits of the significand start with the leftmost nonzero 
decimal digit and continue to the right out to the end of 
the significand value. Significant digits beyond 15 for a 
long float receiver may not be preserved in the result 
and only serve to provide for uniqueness of the 
conversion as well as for proper rounding. 


The result of this conversion is then normalized and 
rounded (according to the current float rounding mode) 
to the significand length of the operand 1 field. 


The converted, normalized, and rounded result is then 
assigned to operand 1 in the long floating-point format. 
The result is subject to the normal floating-point 
overflow and underflow exception detection performed 
on assignment. 


When floating-point overflow or underflow is detected 
and unmasked, the instruction operation is suppressed. 
This action occurs because all overflowed and 
underflowed values cannot be represented in the result 
field format even when employing the modified biased 
exponent representation. 


Conversion of a zero value significand operand results in 
a zero value of the same sign being assigned to operand 
1. 


Operands 2 and 3 are checked for valid decimal sign 
and digit codes. The data exception is signaled if any 
invalid values are encountered, and the operation is 
suppressed. If an even number of digits is specified for 
either the exponent or the significand operands, the 
leftmost digit position of the packed operand field is not 
checked and is not used as part of the decimal value. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands may overlap. 


Program Exceptions: 
— Address translation 
— Addressing 
— Data 
— Effective address overflow 
— Floating-point inexact result 
— Floating-point overflow 


— Floating-point underflow 
— Specification 


CVDFLF Example 

fer ([siel & [el 
CE 040 2 064 

O Bits 8 12 16 20 32 36 47 

Assembler: CVDFLF D, (B;), D2 (B2) 

Machine: CEOD 2040 2064 

B, (2) and B,(2): 800D OCOO 0000 

B;(E): 800D OCOO 0300 

R(F): 0712 


Storage — Before 
800D OCOO 0040 


800D OCO00 0064 
800D OCO00 0300 





Storage — After 


800D OC00 0040 
800D OCO0 0064 
800D OCO00 0300 
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CONVERT DECIMAL FORM TO SHORT FLOAT 
(CVDFSF) 


Instruction Description 


The decimal form of a floating-point value specified by 
a decimal exponent (operand 2) and a decimal 
significand (operand 3) is converted to binary 
floating-point format, and the result is placed in the 
binary floating-point field specified by the first operand. 


Format: SS 


pole} oo, |e) o 


O Bit 8 12 16 20 32 36 47 


Operation: The first operand specifies a binary 
floating-point field that occupies 4 bytes, and has the 
short floating-point field format. 


The second operand specifies the decimal exponent that 
occupies from 1 through 16 bytes as specified by the 
operand 4 value. This operand has the packed 
fixed-point decimal format. 


The third operand, base register hex E, specifies the 
address of the decimal significand. This operand 
occupies up to 16 bytes of storage as specified by the 
operand 4 value and has the packed fixed-point decimal 
format. 


The fourth operand, halfword register hex F, contains 
the digit lengths of the second and third operands. The 
total number of digits for the exponent (operand 2) is 
contained as a value between 1 and 31 in the leftmost 
byte of the halfword register. The total number of digits 
for the significand (operand 3) is contained as a value 
between 1 and 31 in the rightmost byte of the halfword 
register. The specified digit lengths must be within the 
allowable ranges or a specification exception is signaled. 
The length of operands 2 and 3 (in bytes), is calculated 
by dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The specified number of digits are 
considered right adjusted in their respective fields. An 
even value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 
digit position of the corresponding operand value. 
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The exponent and significand contain a decimal form of 
a floating-point number. The value of this number is: 


Value = M * (10**E) 
where: 
M = the value of the significand 
E = the value of the exponent operand 
** denotes exponentation 
* denotes multiplication 


The exponent is assumed to contain a decimal integer 
value. This signed integer value specifies a power of 10 
that gives the floating-point value its magnitude. It has 
an assumed decimal point immediately to the right of its 
rightmost digit position. 


The significand is assumed to contain a decimal value 
with a leading integer digit in its leftmost digit position 
and fractional digits in the digit positions to the right of 
the integer digit. The signed decimal value specifies the 
decimal digits that give the floating-point value its 
precision. The significand has an assumed decimal point 
immedately to the right of its leftmost digit position. 


The decimal form floating-point value specified by the 
exponent and significand operands is converted to 
binary floating-point format as if to infinite precision. 
However, the precision provided for in floating-point 
fields is not as great as the precision that can be 
provided for by decimal fields. Short floating-point 
provides for unique representation of a maximum of 7 
significant decimal digits of precision. The significant 
digits of the significand start with the leftmost nonzero 
decimal digit and continue to the right out to the end of 
the significand value. Significant digits beyond 7 for a 
short floating-point receiver may not be preserved in the 
result and only serve to provide for uniqueness of the 
conversion as well as for proper rounding. 


The result of this conversion is then normalized and 
rounded (according to the current float rounding mode) 
to the significand length of the operand 1 field. 


The converted, normalized, and rounded result is then 
assigned to operand 1 in the short floating-point format. 
The result is subject to the normal floating-point 
overflow and underflow exception detection performed 
on assignment. 


When floating-point overflow or underflow is detected 
and unmasked, the instruction operation is suppressed. 
This action occurs because all overflowed and 
underflowed values cannot be represented in the result 
field format even when employing the modified biased 
exponent representation. 


Conversion of a zero value significand operand results in 
a zero value of the same sign being assigned to operand 
1. 


Operands 2 and 3 are checked for valid decimal sign 
and digit codes. The data exception is signaled if any 
invalid values are encountered, and the operation is 
suppressed. If an even number of digits is specified for 
either the exponent or the significand operands, the 
leftmost digit position of the packed operand field is not 
checked and is not used as part of the decimal value. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands may overlap. 


Program Exceptions: 


— Address translation 

— Addressing 

— Data 

— Effective address overflow 
— Floating-point inexact result 
— Floating-point overflow 

— Floating-point underflow 

— Specification 


CVDFSF Example 


Op D, D, 
AE 058 064 


O Bits 8 12 16 20 32 36 47 
Assembler: CVDFSF D, (B,), D, (B,) 
Machine: AEOD 2058 2064 
B,(2) and B,(2): 800D OCOO 0000 
B(E): 800D OCOO 0300 
R(F): 0709 
Storage — Before 
800D OCO0 0058 


800D OCO0O 0064 
800D OCO0 0300 3480 4687 





Storage — After 


0/8 2/A 
800D OCOO 0058 405E C000 
800D OCOO 0064 
800D OCOO 0300 3480 4687 
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CONVERT LONG FLOAT TO BINARY (CVLFB) 


Instruction Description 


The value stored at the second operand location is 
converted from floating-point to binary and placed in 
the first operand. 


Format: SS 


sie] oo |e) 
8 12 


O Bits 16 20 32 36 47 


Operation: Operand 1 has a signed binary format and is 
either 2, 4, or 8 bytes in length. The length of the 
operand is determined by an options mask. 


Operand 2 is 8 bytes long, and has a long floating-point 
format. The data for this operand must be fullword 
aligned; otherwise, a specification exception occurs, and 
the operation is suppressed. 


Operand 3 is a 4-bit options mask (bits 8 through 11) 
that controls the conversion operation. The format of 
the options mask Is: 


Bits Meaning 


8 Mode of rounding to be performed. 
O = Round using current floating-point 
rounding mode in effect. 
1 = Round using decimal round 
algorithm. 


9-11 Length of binary result (operand 1). 
001 = 2 bytes. 
011 = 4 bytes. 
111 = 8 bytes. 


All other values are invalid. 


The floating-point value of the second operand is 
converted to a fixed-point binary integer format. If 
necessary, the floating-point value is rounded to an 
integer value. 
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The rounding mode is specified by the options mask (bit 
8 of operand 3). If floating-point rounding is specified, 
rounding is performed according to the current 
floating-point rounding mode in effect. If decimal 
rounding mode is specified, the current floating-point 
rounding mode is overridden, and the decimal round 
algorithm is performed. In this case, a value of 1/2 (a 1 
bit) is added to the leftmost bit position of the fractional 
portion of the floating-point value, and that bit and 
those bits to the right are truncated from the resulting 
value. 


The value assigned to operand 1 is formed as a 
right-aligned, binary integer value with an assumed 
binary point immediately to the right of its rightmost 
digit. 


If the rounded integer portion of the floating-point value 
is O, the first operand value is set to O, and the sign is 
set positive, regardless of the sign of the second 
operand. 


An invalid floating-point conversion exception is 
signaled for any number outside the range of integer 
values that can be contained in operand 1 (this includes 
NaNs and infinities). 


The result obtained from overlapping operands is 
unpredictable. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must be 
on a fullword boundary; otherwise, a specification 
exception occurs. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 

— Floating-point invalid operand 
— Invalid floating-point conversion 
— Specification 


J 


Programming Note: The following is a summary of the CVLFB Example 





results for various combinations of operands. 
C Op |M, D, 
CE 7 060 
Receiver Source O Bit 8 12 16 20 32 36 47 
0 +0 Assembler: CVLFB D,(B,), D,(L,By) 
-B -R Machine: CE78 4050 4060 
+B +R 
B, (4) and B, (4): 0010 0200 0000 
IFPC +INF 
IFPC MNAN Storage — Before 
IFPC UNAN 0/8 2/A 
0010 0200 0050 XXXX XXXX 
peaend: 0010 0200 0060 | 416F £000 
R = Real nonzero floating-point number 
B = A nonzero binary number 


Storage — After 





MNAN = A masked NAN 
UNAN = Anunmasked NAN 0/8 2 /A 
F 

INE _ Infinity 0010 0200 0050 OOFF 0000 
0010 0200 0060 416F E000 

IFPC = An invalid floating-point conversion 

exception. 
The assignment of a real number (R) as the value of the Condition Code: Not changed. 


binary field (B) is only successful if R is a value that can 
be contained within the value range of the binary field; 
otherwise, an invalid floating-point conversion may 
result. 
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CONVERT LONG FLOAT TO DECIMAL FORM 
(CVLFDF) 


Instruction Description 


The binary floating-point value specified by operand 5 is 
converted to a decimal form of a floating-point value (a 
decimal exponent and a decimal significand) and placed 
into operand 1 (exponent) and operand 2 (significand) 
locations. 


Format: SS 


cle] oo, |e) 


O Bitt 8 12 16 20 32 36 47 


Operation: The first operand specifies the decimal 
exponent and occupies from 3 through 16 bytes as 
specified by the operand 4 value. This operand is 
formed using the packed fixed-point decimal format. 


The second operand specifies the decimal significand, 
and occupies a maximum of 16 bytes as specified by 
the operand 4 value. This operand is formed using the 
packed fixed-point decimal format. 


The third operand, bits 8 through 11, specifies an 
options mask to control the conversion operation. 


Bits Meaning 


8 Mode of rounding to be performed. 


QO = Round using current float rounding 
mode in effect. 

1 = Round using decimal round 
algorithm. 


9-11 Reserved. 


10-124 


the digit lengths of the first and second operands. The 
total number of digits for operand 1 is specified as a 
value between 5 and 31 in the leftmost byte of the 
halfword register. The total number of digits for 
operand 2 is specified as a value between 1 and 31 in 
the rightmost byte of the halfword register. The 
specified digit lengths must be within the allowable 
ranges or a specification exception is signaled. The 
length of operands 1 and 2 (in bytes) is calculated by 
dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The number of digits specified are 
considered right adjusted in their respective fields. An 
even-value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 
digit position of the corresponding operand value. 


The fourth operand, halfword register hex F, contains ) 


The fifth operand, base register hex E, specifies the 
address of the binary floating-point number. The 
number occupies 8 bytes, and has the long 
floating-point field format. 


The exponent (operand 1) and significand (operand 2) 
contain a decimal form of a floating-point number. The 
value of this number is: 


Value = M * (10**E) Ss) 


where: 
M = the value of the decimal significand operand 
E = the value of the exponent operand 
** denotes exponentiation 
* denotes multiplication 


The exponent is formed as a decimal integer value. The 
exponent, which gives the floating-point value its 
magnitude, contains a signed integer value that specifies 
a power of 10. The exponent has an assumed decimal 
point immediately to the right of its rightmost digit 
position. 


The significand is formed as a decimal value with a 
single integer digit in its leftmost digit position and 
fractional digits in the digit positions to the right of the 
integer digit. The significand contains a signed decimal 
value that specifies decimal digits, to give the 
floating-point value its precision. The significand has an 
assumed decimal point immediately to the right of its 
leftmost digit position. 


The binary floating-point source is converted to a 
decimal form floating-point value as if to infinite 
precision. However, the precision provided for by 
floating-point fields is not as great as the precision 
provided for by decimal fields. Long floating-point 
provides for unique representation of a maximum of 15 
significant decimal digits of precision. The significant 
digits of the significand start with the leftmost nonzero 
decimal digit and continue to the right out to the end of 
the significand value. The converted significand value is 
formed as a normalized value, the significant digits are 
left adjusted in the converted value, and the converted 
exponent is set accordingly. Significand digits beyond 
the leftmost 15 provide for uniqueness of the conversion 
and should be considered only as precise as the 
floating-point calculations that produced the source 
value. 


The converted significand value is adjusted to the 
precision of the significand operand, if necessary, by 
using the rounding algorithm specified in the options 
mask operand. If the rounding algorithm causes a carry 
out of the leading integer digit position, the converted 
rounded significand value is shifted right one digit 
position and the converted exponent incremented by 1 
to realign the significand back to having one leading 
integer digit. If floating-point rounding is selected, 
rounding is performed according to the current 
floating-point rounding mode in effect. If decimal 
rounding is selected, the current floating-point rounding 
mode is overridden and the decimal round algorithm is 
performed. In this case, a value of 5 is added to the 
converted significand in the leftmost digit position not 
provided for in operand 2, and that digit, and those 
digits to the right of it, are truncated from the resulting 
significand value. 


The result of this conversion is then assigned to the 
exponent and significand operands. For an exponent or 
significand operand with an even number of digits, the 
leftmost digit position of the packed field in the operand 
is set to binary 0. 


If the binary floating-point number being converted 
contains a value of O, the exponent operand is set to 
positive 0, and the significand operand is set to O with 
the sign of the binary floating-point number. A positive 
O is set with the preferred positive sign of hex F. A 
negative O is set with the preferred negative sign of hex 
D. 


A decimal overflow exception cannot occur on the 
assignment of the exponent or significand values. 


When the binary floating-point number being converted 
contains a denormalized floating-point value, the first 
and second operand values are set with the correctly 
converted and rounded values; no exception is signaled. 
When an infinity or NaN value is encountered in the 
second operand, the invalid floating-point conversion 


exception is signaled and the instruction operation is 
suppressed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlap between operands 1 and 2 is unpredictable. 


Program Exceptions: 


Address translation 

Addressing 

Effective address overflow 
Invalid floating-point conversion 
Specification 
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Programming Note: The following is a summary of the 
results for various combinations of operands where: 


Receivers Source 
-0*10**+0 -0 
+0*10**+0 +0 
-M*10**+E -R<-1 
+M*10**+E +R>1 
-M*10**-E -R>-1 
+M*10**-E +R<1 
IFPC +INF 
IFPC MNaN 
IFPC UNaN 
Legend: 

R = a real nonzero, non-denormal 


floating-point number 


E = the exponent, a nonzero decimal 
number 

M = the significand, a nonzero decimal 

MNaN = a masked NaN 

UNaN = —_ an unmasked NaN 

INF = infinity 

IFPC = invalid floating-point conversion 


exception 
ue denotes exponentiation 


denotes multiplication 
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CVLFDF Example 


OP E D, D, Jo 
CE C 064 070 
12 


O Bits 8 16 20 32 36 47 





Assembler: CVLFDF D, (B;), D2 (B2), M., 
Machine: CEOC 2064 2070 

B, (2) and B,(2): 800D OCOO 0000 
B(E): 800D OCO0 0300 

R(F): 0712 


Storage — Before 


0/8 2/A 


800D OCOO 0064 
800D OCO0O 0070 XXXX  XXXX 


XXXX 
800D OC00 0300 405E coo0o 


Storage — After - 


0/8 2/A 





800D OCOO 0064 
800D OCO0 0070 0123 0000 


OOOF 
800D OCOO 0300 405E co0o0o 





CONVERT LONG FLOAT TO PACKED DECIMAL 
(CVLFPD) 


Instruction Description 


The value of the second operand is converted from 
floating-point to packed decimal, and the result is 
placed in the first operand location. 


Format: SS 


ale} oo, |e) 
8 12 


0 Bits 16 20 32 36 47 


Operation: The first operand occupies up to 16 bytes of 
storage, as specified by the operand 4 value, and is 
formed according to the packed fixed-point decimal 
format. 


The second operand occupies 8 bytes and has the long 
floating-point field format. 


The third operand, bits 8 through 11, specifies an 
options mask to control the conversion operation. 


Bits Meaning 


8 Mode of rounding to be performed. 


O = Round using current float rounding 
mode in effect. 
1 = Round using decimal round 
algorithm. 
9-11 Reserved. 


The fourth operand, halfword register hex F contains the 
total and fractional digit count information for the 
number of decimal digits contained in the first operand. 
The total number of digits for operand 1 is contained, as 
a value between 1 and 31, in the leftmost byte of the 
halfword register. The number of-fractional digits for 
operand 1 is contained as a value between 0 and 31, in 
the rightmost byte of the halfword register. The 
specified digit lengths must be within the allowable 
ranges or a specification exception is signaled. The 
number of integer digits in operand 1 is determined by 
subtracting the fractional digit count from the total digit 
count. The length of operand 1, in bytes, is calculated 
by dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The number of digits specified are 
considered right adjusted in the operand 1 field. An 
even-value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 
digit position of the operand value. 


The floating-point value is converted to a fixed-point 
packed decimal number as if to infinite precision. 
However, the precision provided for in floating-point 
fields i 1:0t as great as that which can be provided for 
by decimal fields. Long floating-point provides for 
unique representation of a maximum of 15 significant 
decimai digits of precision. The leftmost nonzero digit of 
the converted packed decimal number is considered the 
start of the significant digits of the number. Significant 
digits produced in the first operand beyond the first 15 
for long floating-point serve to provide for uniqueness 
of conversion and should be considered only as precise 
as the calculations that produced the floating-point 
number. 


The result of this conversion is then rounded, if 
necessary, to match the fractional precision of the 
operand 1 field.. The rounding algorithm performed is 
controlled by the third operand mask value. If 
floating-point rounding is selected, rounding is 
performed according to the current floating-point 
rounding mode in effect. If decimal rounding is selected, 
the current floating-point rounding mode ts overridden 
and the decimal round algorithm is performed. In this 
case, a value of 5 is added to the converted number in 
the leftmost digit position not provided for in operand 1, 
and that digit, and those to the right of it, are truncated 
from the resulting sum. 
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The converted and rounded result is then assigned to 
operand 1 in the fixed-point packed decimal format for 
the number of digits specified by the total digit count 
for operand 1. If an even number of digits was 
specified, the leftmost digit position of the packed 
operand 1 field is set to binary O. 


lf the converted and rounded result is O, the first 
operand value is set to O and the sign is set positive, 
regardiess of the sign of the second operand. 


When a denormalized floating-point value is converted 
from the source operand, the first operand is set with 
the correctly rounded value, and no exception is 
signaled. 


When any nonzero integer digits are truncated on the 
left in assigning the converted and rounded result to 
operand 1, or when an infinity value or a NaN value is 
encountered in the second operand, the invalid 
floating-point conversion exception is signaled and the 
instruction operation is suppressed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredicatable. 


Program Exceptions: 


Address translation 

Addressing 

Effective address overflow 
Invalid floating-point conversion 
Specification 
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Programming Note: The following is a summary of the 
results for various combinations of operands. 


Receiver Source 

+0 +RO 

-D -R 

+D +R 

IFPC +INF 

IFPC MNaN 

IFPC UNaN 

Legend: 

R = a real nonzero value converted and 


rounded form of the source 
floating-point number 


RO = a real zero value converted and 
rounded form of the source 
floating-point number 

D = a nonzero decimal number 

MNaN = a masked NaN 

UNaN = an unmasked NaN 

INF = infinity 

IFPC = invalid floating-point conversion 


exception 


The assignment of a real number, R, as the value of the 
decimal field, D, is only successful if R is a value that 
can be contained within the value range of the decimal 


field; otherwise, an invalid floating-point conversion may 


result. 


J 


C 


CVLFPD Example 
Op E D, B, 
CE A 068 2 
O Bits 8 12 16 20 32 36 47 
Assembler: CVLFPD D, (B,; ), D, (B,), M3 
Machine: CEOA 2068 2050 
B, (2) and B,(2): 800D OCOO 0000 
R(F): 0703 


Storage — Before 


0/8 2/A 
800D OCOO 0068 XXXX XXXX 
800D OCOO 0050 405E  co0oo 





Storage — After 


0/8 2/A 
800D OCO0 0068 0123 OOOF 
800D OCOO 0050 405E  co0oo 
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CONVERT LONG TO SHORT FLOAT (CVLSF) 


Instruction Description 
The value of the second operand is converted from the 
long floating-point format to the short floating-point 


format, and the result is placed in the first operand 
location. 


Format: SS 


zie) oo jel 
8 12 


O Bits 16 20 32 36 47 


Operation: The first operand occupies 4 bytes in storage 


and is formed using the short floating-point field format. 


The second operand occupies 8 bytes in storage and 
has the long floating-point field format. 


When the second operand contains a normalized 
nonzero floating-point value, the significand value from 
the second operand is rounded (according to the current 
rounding mode) to the short floating-point format 
significand length. The biased exponent value of the 
second operand is adjusted to the correct biased 
exponent value for the short floating-point format. This 
converted floating-point value is then assigned to the 
first operand according to the short floating-point field 
format. This operation is subject to the detection of the 
floating-point overflow and underflow conditions. 


When the second operand contains a value of 0, the 
first operand is assigned a zero value of the same sign. 


When the second operand contains an infinity 
floating-point value or a masked NaN value, the 
exponent and significand values are truncated on the 
right to the length of the short format prior to their 
assignment into the first operand. If the truncation of a 
masked NaN results in a fraction value of O, the system 
default masked NaN value is assigned to the first 
operand. 
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When the second operand contains an unmasked NaN 
value, the floating-point invalid operand condition is 
detected. For the case where an unmasked NaN value 
is encountered and the floating-point invalid operand 
exception is masked, the first operand is assigned a 
masked NaN value with the fraction value from the 
Original unmasked NaN truncated on the right to the 
short format fraction length. If the truncation of the 
unmasked NaN results in a fraction value of O, the 
system default masked NaN value is assigned to the 
first operand. 


If the second operand contains a denormalized 
floating-point number, the floating-point underflow 
condition is detected. 


If the floating-point underflow condition is detected and 
masked, the result is assigned a value as defined by the 
floating-point underflow exception in Chapter 6. If this 
condition is detected and unmasked, the floating-point 
underflow condition is signaled. However, the operation 
is Suppressed, and no result is stored. This action is 
taken because the underflowed value cannot be 
represented in the short format result field, even when 
employing the modified biased exponent representation. 


In addition to the previous exception conditions of 
floating-point overflow and floating-point underflow, the 
floating-point inexact result and floating-point invalid 
operand conditions can be detected as a result of the 
execution of this instruction. Refer to Chapter 6 for a 
detailed description of these conditions and the 
instruction status when one of these conditions is 
detected. 


J 


J 





Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not changed. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point overflow 

— Floating-point underflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Specification 


CVLSF Example 
Op E |B, D, B, 
CE 7 | 2 058 2 
O Bits 8 12 16 20 32 36 47 
Assembler: CVLSF D, (B, ), D2 (B,) 
Machine: CEQ7 2058 2050 
B,(2) and B,(2): 800D OCOO 0000 


Storage — Before 

0/8 2/A 

800D OCOO 0058 XXXX XXXX 
800D OCOO 0050 405E coo0d 





Storage — After 


0/8 2/A 
800D OCOO 0058 42F6 0000 
800D OCOO 0050 405E cCoo0o 
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Instruction Descriptions 


CONVERT MULTI-LEAVING REMOTE JOB ENTRY 
TO CHARACTER (CVTMC) 


Instruction Description 


The operation converts the data at the second operand 
location from MRJE (MULTI-LEAVING Remote Job 
Entry) to character format. The conversion is controlled 
by information whose address is in the base register 
specified in the third operand. The result is placed in 
the first operand. 


The operands are as follows: 


Operand Description 


1 The base and displacement for the 
starting address of the result string that 
is to contain the converted data. 


2 The base and displacement for the 
starting address of the source string that 
contains the data to be converted. 


3 The base register that contains the 
address of the control information for 
the conversion operation to be 
performed. 


4 Halfword register 14 specifies the length 
of the first operand (result string). A 
length of zero causes a specification 
exception. 


5 Halfword register 15 specifies the length 
of the second operand (source string). A 
length of zero causes a specification 
exception. 


The controls operand is a 6-byte string that specifies 
additional information to control the conversion 
Operation. The controls operand has the following 
format: 





Result Source Mod- eeu 
Offset Offset ifier oeee 
Length 

0 Bytes 2 4 5 

Bytes Description 

0-1 Result offset 

2-3 Source offset 

4 Modifier 

5 Result record length 
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source offset fields specify the offsets at which bytes of 
the source field are processed and entered into the 
result field. The source and result offset fields are set to 
values which indicate how much of the conversion is 
complete when the instruction is interrupted or 
complete. An offset beyond the end of the related 
source or result operand causes a specification 
exception. 


Upon input to the instruction, result offset and the 
) 


The modifier has the following valid values: 


Value 
(Hex) Description 


00 Do not move subrecord control blocks 
from the source into the result. 


01 Move subrecord control blocks 
from the source into the result. 


Note: An invalid modifier causes a specification 
exception. 


The result record length specifies the record length to be 
used to convert source records into the result. A length 
of zero causes a specification exception. 3 


Format: SS 


[ee [eloje| o jel o 
8 12 


0 Bits 16 20 32 36 47 


Operation: The operation begins by accessing the bytes 
of the source operand at the location specified by the 
source offset. This location is assumed to be the start 
of a record. The source operand bytes are converted 
into the result according to the following procedure. 


The first byte of the source record is considered a byte 
of a record control block to be ignored during 
conversion. 


The second byte of the source record is considered to 
be a subrecord control block. If a modifier of hex OO is 
specified, the subrecord control block is ignored. If a 
modifier of hex 01 is specified, the subrecord control 
block is copied into the result. 


The following bytes of the source record make up the 
string control bytes. One or more string control bytes )) 
describe the strings to be built in the result record. 


C 


The format of the string control bytes is as follows: 


Value 
Byte Bit (Binary) Description 
0-1 0 0 End of record; the end-of-record string control byte is hex OO. 
1 All other string control bytes. 
1 6) The string is compressed. 
1 The string is not compressed. 
2 When bit 1 = 0. 
0 Blanks (hex 40s) have been deleted. 
1 Nonblank characters have been deleted. The next character in the data stream is 
the specimen character. 
When bit 1 = 1, this bit is part of the length field for length of uncompressed data. 
3-7 00001 - If bit 1 = 0, this is the number of characters that have been deleted. 
11111 
2-7 000001- =—‘iIf bit 1 = 1, this is the number of characters before the next string control block (no 


111111 compression). The uncompressed (unidentical) bytes follow the string control bytes 


in the data stream. 


Note: A length of zero in a string control byte results in 
a conversion exception. 


Strings of blanks or nonblank identical characters 
described in the source record are repeated in the result 
operand the number of times indicated by the string 
control block count. Strings of nonidentical characters 
described in the source record are moved into the result 
operand for the length indicated by the string control 
byte count. 


The operation applies the above procedure to each 
record in the source until it encounters the end of the 
source. Updated values for the result offset and source 
offset are put into the appropriate fields in the controls 
operand. These values describe the start offsets for the 
next record to be converted, allowing for interruption of 
the instruction on a record boundary. 


When an end-of-record string control byte (hex OO) is 
encountered in the source, the result is padded with 
blanks out to the end of the current record. 


When the end-of-source record is encountered, 
whether or not in conjunction with a record boundary or 
end-of-string record control byte in the source, the 
instruction ends with a condition code of zero (source 
used up). See Programming Note. 


If the converted form of a record cannot be completely 
contained in the result, the instruction ends with a 
condition code of 1 (result overrun). See Programming 
Note. 


If the converted record is larger than the result record 


length, the instruction terminates by signaling a length 
conformance exception. 
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Programming Note: The result offset locates the byte 
following the last fully converted record in the result. 
The source offset locates the byte following the last 

source record for which conversion is complete. The 
contents of the remaining bytes in the result after the 
last converted record are unpredictable. 


Any form of overlap between the operands on this 


instruction yields unpredictable results in the result 
operand. 


Overflow and Sign Codes: Not applicable. 


Condition Code: 


Source used up 
Result overrun 


QO NH — © 


Carry and Boundary Requirements: Not applicable. 


Program Exceptions: 


— Address translation 

~— Addressing 

— Conversion 

— Effective address overflow 
— Length conformance 

— Specification 
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CVTMC Example ) 
Op B, D, B, D 
BE 3 6A8 4 644 
12 


O Bits 8 16 20 32 36 47 


Assembler: CVTMC D,(B,),D2(B,),B; 
Machine: BE55 36A8 4644 


B, (3): 0001 236A 0000 (Base register for result) 

B2 (4): 0001 136A 0000 (Base register for source) 

B3 (5): 0001 036A 0620 (Address of control operand) 
R (14): 0020 (Length of result) 

R (15): 0014 (Length of source) 


Storage—Before 


0/8 2/A 
0001 O36A 0620 |0000 oO00O0 


0001 136A 0644 


C8E3 C5E2 
E300 FF80 
0001 236A O6A8 | XXXX XXXX 2 


XXXX XXXX 
XXXX XXXX 
XXXX XXXX 





Storage—After 


0/8 2/A 
0001 O36A 0620 | 0020 £0014 


0001 136A 0644 


0001 236A O6A8 





Before After 
Condition Code: Xx 0 


This page is intentionally left blank. 
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CONVERT PACKED DECIMAL TO LONG FLOAT 
(CVPDLF) 


Instruction Description 


The value of the second operand is converted from 
packed decimal to floating-point, and the result is 
placed in the first operand location. 


Format: SS 


ele) oo jel o 
8 12 


0 Bits 16 20 32 36 47 


Operation: The first operand occupies 8 bytes and is 
formed according to the long floating-point field format. 


The second operand occupies up to 16 bytes of storage, 
as specified by the operand 3 value, and has the packed 
fixed-point decimal format. 


The third operand, halfword register hex F, contains the 
total and fractional digit count information for the 
number of decimal digits contained in the second 
operand. The total number of digits for operand 2 is 
contained, as a value between 1 and 31, in the leftmost 
byte of the halfword register. The number of fractional 
digits for operand 2 is contained as a value between O 
and 31 in the rightmost byte of the halfword register. 
The specified digit lengths must be within the allowable 
ranges or a specification exception is signaled. The 
number of integer digits in operand 2 is determined by 
subtracting the fractional digit count from the total digit 
count. The length of operand 2 in bytes, is calculated by 
dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The number of digits specified are 
considered right adjusted in the operand 2 field. An 
even-value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 
digit position of the operand value. 
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The fixed-point decimal value is converted to 
floating-point as if to infinite precision. However, the J 
precision provided by floating-point fields is not as great 

as that which can be provided by decimal fields. Long 

floating-point provides for unique representation of a 

maximum of 15 significant decimal digits of precision. 

The leftmost nonzero digit of the packed decimal 

number is considered the start of the significant digits of 

the number. Significant digits in the second operand 

beyond the first 15 for long floating-point may not be 

preserved in the result field and only serve to provide 

for rounding and uniqueness of conversion. 


The result of this conversion is then normalized and 
rounded (according to the current floating-point 
rounding mode) to the significand length of the operand 
1 field. The converted, normalized, and rounded result is 
then assigned to operand 1 in the long floating-point 
format. 


Conversion of a zero value second operand results in a 
zero value of the same sign being assigned to operand 
le 


Operand 2 is checked for valid decimal sign and digit 

codes. The data exception is signaled if any invalid . 
values are encountered, and the operation is J 
suppressed. If an even number of digits was specified, 

the leftmost digit position of the packed operand 2 field 

is not checked and is not used as part of the fixed-point 

decimal value. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. 


Program Exceptions: 


— Address translation 

— Addressing 

— Data 

— Effective address overflow 
— Floating-point inexact result 
— Specification 


CVPDLF Example 


Op D, D, 
CE 040 O06C 
0 Bit 8 12 16 20 32 36 47 


Assembler: CVPDLF D, (B, ), D, (B;) 
Machine: CEOB 2040 206C 


B, (2) and B, (2): 800D OCOO 0000 


R(F): 07 
FI a Storage — Before 


0/8 2/A 


800D OCO0O 0040 XXXX XXXX 
800D OCO0O OO6C 





Storage — After 
0/8 2/A 


800D OCOO 0040 BF7C ACO08 
800D OCO0 O06C 
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CONVERT PACKED DECIMAL TO SHORT FLOAT 
(CVPDSF) 


Instruction Description 


The value of the second operand is converted from 
packed decimal to floating-point, and the result is 
placed in the first operand location. 


Format: SS 


jele] o |e} 
8 12 


0 Bits 16 20 32 36 47 


Operation: The first operand occupies 4 bytes and is 
formed according to the short floating-point field 
format. 


The second operand occupies up to 16 bytes of storage, 
as specified by the operand 3 value, and has the packed 
fixed-point decimal format. 


The third operand, halfword register hex F, contains the 
total and fractional digit count information for the 
number of decimal digits contained in the second 
operand. The total number of digits for operand 2 is 
contained, as a value between 1 and 31, in the leftmost 
byte of the halfword register. The number of fractional 
digits for operand 2 is contained as a value between O 
and 31 in the rightmost byte of the halfword register. 
The specified digit lengths must be within the allowable 
ranges or a specification exception is signaled. The 
number of integer digits in operand 2 is determined by 
subtracting the fractional digit count from the total digit 
count. The length of operand 2, in bytes, is calculated 
by dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The number of digits specified are 
considered right adjusted in the operand 2 field. An 
even-value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 
digit position of the operand value. 
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The fixed-point decimal value is converted to 
floating-point as if to infinite precision. However, the 
precision provided by floating-point fields is not as great 
as that which can be provided by decimal fields. Short 
floating-point provides for unique representation of a 
maximum of 7 significant decimal digits of precision. 
The leftmost nonzero digit of the packed decimal 
number is considered the start of the significant digit of 
the number. Significant digits in the second operand 
beyond the first 7 for short floating-point may not be 
preserved in the result field and only serve to provide 

for rounding and uniqueness of conversion. 


The result of this conversion is then normalized and 
rounded (according to the current floating-point 
rounding mode) to the significand length of the operand 
1 field. The converted, normalized, and rounded result is 
then assigned to operand 1 in the short floating-point 
format. 


Conversion of a zero value second operand results in a 
zero value of the same sign being assigned to operand 
1. 


Operand 2 is checked for valid decimal sign and digit 
codes. The data exception is signaled if any invalid 
values are encountered, and the operation is 
suppressed. If an even number of digits was specified, 
the leftmost digit position of the packed operand 2 field 
is not checked and is not used as part of the fixed-point 
decimal value. 


2 





Overflow and Sign Code: Not applicable. CVPDSF Example 





Condition Code: Not changed. 


0 Bits 12 16 20 32 36 


Carry: Not applicable. Assembler: CVPDSF D, (B,), D, (B,) 


Machine: AEQB 2058 206C 
Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. B, (2) and B,(2): 800D OCOO 0000 


R(F): 0703 
Program Exceptions: 


Storage — Before 
— Address translation 





— Addressing 

— Data 800D OCOO 0058 
— Effective address overflow 800D OCo0 006C 
— Floating-point inexact result 

— Specification 


Storage — After 


0/8 2/A 
800D OCOO 0058 BBE5 6042 
800D OCOO O06C 
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CONVERT PACKED TO BINARY (CVPB) 
Instruction Description 
The radix of the second operand is changed from 


decimal to binary, and the result is placed in the 
first-operand location. 


Format: SS 
(| lols| o [a] o, _ 
O Bits 12 16 20 32 36 47 


Operation: The number is treated as a right-aligned, 
binary value both before and after conversion. The 
second operand occupies 8 bytes in storage and has the 
packed decimal format. The digit codes are checked for 
validity. Improper codes cause a data exception and the 
operation is terminated. The first operand occupies a 
word in storage and is formed using the signed binary 
format. 


The maximum number that can be converted to a. 
32-bit, signed, binary integer is 2 147 483 647; the 
minimum number is -2 147 483 648. For any number 
outside this range, the operation is completed by placing 
the rightmost 32 bits in the first-operand location and 
causing a binary overflow exception. 


Overflow: See Operation. 


Sign Code: The sign code is checked for validity. An 
improper code causes a data exception and the 
operation is terminated. 


Condition Code: Not changed. 


Carry: Not applicable. 
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word boundary; otherwise a specification exception 
occurs and the operation is suppressed. The operands 
can overlap in storage. 


Boundary Requirements: Both operands must begin on a | 
> 


Program Exceptions: 
— Address translation 
— Addressing 
— Binary overflow 
— Data 


— Effective address overflow 
— Specification 


CVPB Example 


Op 
F7 


O Bits 12 16 20 32 36 47 
Assembler: CVPB D,(B,), D2(B>) 
Machine: F700 3760 3430 


B, (3) and By (3): 1810 2561 Co00 ) 


Storage — Before 


1810 2561 C430 
1810 2561 C760 





Storage — After 


0/8 2/A 
1810 2561 C430 0000 0214 
1810 2561 C760 7FFF FFFF 





CONVERT PACKED TO ZONED (CVPZ) 
Instruction Description 


The format of the second operand is changed from 
packed to zoned, and the result is placed in the 
first-operand location. 


Format: SS 


[rs |ululel o [el o 
8 12 


O Bits 16 20 32 36 47 


Operation: The digits and sign of the second operand 
are placed unchanged in the first-operand location, 
using the zoned format. Zones with coding of 1111 are 
supplied for all bytes except the rightmost byte, which 
receives the sign of the packed operand. The operand 
sign and digits are not checked for valid codes. 


The result is obtained as if the field were processed 


right to left. If necessary, the second operand is 
logically extended to the left with zero digits. 


Overflow: If the first-operand field is too short to 
contain all significant digits of the second-operand field, 
decimal overflow occurs and the leftmost significant 
digits are lost. 


Sign Code: See Operation. 
Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 


rightmost byte of the first operand is to the right of the 
rightmost byte of the second operand by the number of 
bytes in the second operand minus two; otherwise the 

overlap is destructive and the results are unpredictable. 

if 1 or 2 bytes are converted, the rightmost byte of the 
two operands can coincide. 


Program Exceptions: 


Address translation 
Addressing 

Decimal overflow 
Effective address overflow 


CVPZ Example 





O Bits 8 12 16 20 32 36 47 
Assembler: CVPZ D,(L,, B,), D2(L2, Bo) 

Machine: F573 4270 4100 

B,(4) and B,(4): 30B8 5693 COO0O 


Storage — Before 


0/8 2/A 
30B8 5693 C100 0210 261F 
30B8 5693 C270 XXXX XXXX 





Storage — After 


0/8 2/A 
30B8 5693 C100 0210 261F 
30B8 5693 C270 FOFO F2F1 
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CONVERT PACKED TO ZONED WITH DATA 
CHECKING (CVPZC) 


Instruction Description 
The format of the second operand is changed from 


packed to zoned, and the result is placed in the 
first-operand location. 


Format: SS 
js uiute| |e] o 
O Bits 16 20 32 36 47 


Operation: The digits and sign of the second operand 
are placed unchanged in the first-operand location, 
using the zoned format. Zones with coding of 1111 are 
supplied for all bytes except the rightmost byte, which 
receives the sign of the packed operand. If the sign of 
the packed operand is positive, the preferred sign of 
1111 is used. If the sign of the packed operand is 
negative, the preferred sign of 1101 is used, unless the 
digits are all zero, in which case a plus sign of 1111 is 
used. The operand sign and digits are checked for valid 
codes. 


The result is obtained as if the field were processed 
right to left. If necessary, the second operand is 


logically extended to the left with zero digits. 


The length of each operand is in digits. 


Overflow: |f the first-operand field is too short to 


contain all significant digits of the second-operand field, 


decimal overflow occurs and the leftmost significant 
digits are lost. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements: The operands can overlap if the 

rightmost byte of the first operand is to the right of the J 
rightmost byte of the second operand by the number of 

bytes in the second operand minus two; otherwise, the 

overlap is destructive and the results are unpredictable. 

If 1 or 2 bytes are converted, the rightmost byte of the 

two operands can coincide. 


Program Exceptions: 
— Address translation 
— Addressing 
— Data 


— Decimal overflow 
— Invalid segment group address 


CVPZC Example 


O Bits 12 16 20 32 36 47 


Assembler: CVPZC D, (L,,B,), Dz (Lz, Bz) 
Machine: E576 4270 4100 ») 


B, (4) and B, (4): 30B8 5693 C000 


Storage — Before 


0/8 2/A 
30B8 5693 C100 0210 261F 
30B8 5693 C270 XXXX XXXX 





Storage — After 


0/8 2/A 
30B8 5693 C100 | 0210 261F 
30B8 5693 C270 FOFO F2F1 





CONVERT SHORT FLOAT TO BINARY (CVSFB) 


Instruction Description 


The value stored at the second operand location is 
converted from floating-point to binary and placed in 
the first operand location. 


Format: SS 


fsie] oie) 
8 12 


0 Bits 16 20 32 36 47 


Operation: Operand 1 has a signed binary format and is 
either 2, 4, or 8 bytes in length. The length of the 
operand is determined by an options mask. 


Operand 2 is 4 bytes long, and has a short 
floating-point format. The data for this operand must 
be fullword aligned; otherwise, a specification exception 
occurs, and the operation is suppressed. 


Operand 3 is a 4-bit options mask (bits 8 through 11) 
that controls the conversion operation. The format of 
the options mask is: 


Bits Meaning 


8 Mode of rounding to be performed. 
QO = Round using current floating-point 


rounding mode in effect. 
1 = Round using decimal round 


algorithm. 


9-11 Length of binary result (operand 1). 
001 = 2 bytes. 
011 = 4 bytes. 
111 = 8 bytes. 
All other values are invalid. 


The floating-point value of the second operand is 
converted to a fixed-point binary integer format. If 
necessary, the floating-point value is rounded to an 
integer value. 


The rounding mode is specified by the options mask (bit 
8 of operand 3). If floating-point rounding is specified, 
rounding is performed according to the current 
floating-point rounding mode in effect. If decimal 
rounding mode is specified, the current floating point 
rounding mode is overridden and the decimal round 
algorithm is performed. In this case, a value of 1/2 (a 1 
bit) is added to the leftmost bit position of the fractional 
portion of the floating-point value, and that bit, and 
those bits to the right, are truncated from the resulting 
value. 


The value assigned to operand 1 is formed as a 
right-aligned, binary integer value with an assumed 
binary point immedately to the right of its rightmost 
digit. 


If the rounded integer portion of the floating-point value 
is zero, the first operand value is set to zero, and the 
sign is set positive, regardless of the sign of the second 
operand. 


An invalid floating-point conversion exception is 
signaled for any number outside the range of integer 
values that can be contained in operand 1 (this includes 
NaNs and infinities). 


The result obtained from overlapping operands is 
unpredictable. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must be 
on a fullword boundary; otherwise, a specification 
exception occurs. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 

— Floating-point invalid operand 
— Invalid floating-point conversion 
— Specification 
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1 Programming Note: The following is a summary of the CVSFB Example 


results for various combinations of operands. 
Receiver Source AE 060 








O Bit 8 12 16 20 32 36 47 
0 +0 
: Assembler: CVSFB D, (B,), D,(L,B,) 
- -R 
+B +R Machine: AE38 4050 4060 
IFPC +INF B, (4) and B, (4): 0010 0200 0000 
IFPC MNaN 
Storage — Before 
IFPC UNaN 
0/8 2/A 
Legend: 0010 0200 0050 XXXX - XXXX 
R = a real nonzero floating-point O01 0200 0060 4D80 8080 
number 
B = a nonzero binary number 
MNaN = amasked NaN Storage — After 
INF = infinity 0/8 = 2/A 
|IFPC . an invalid floating-point conversion 0019 0200 0050 1010 1000 
exception 0010 0200 0060 4D80 8080 
\ The assignment of a real number (R), as the value of the 


binary field (B), is only successful if R is a value that can 
be contained within the value range of the binary field; 
otherwise, an invalid floating-point conversion may 
result. 


Condition Code: Not changed. 
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CONVERT SHORT FLOAT TO DECIMAL FORM 
(CVSFDF) 


Instruction Description 


The binary floating-point value specified by operand 5 is 
converted to a decimal form of a floating-point value (a 
decimal exponent and a decimal significand and placed 
into operand 1 (exponent) and operand 2 (significand) 
locations. 


Format: SS 


ei | te Ni iy 


O Bit 8 12 16 20 32 36 47 


Operation: The first operand specifies the decimal 
exponent and occupies from 3 to 16 bytes as specified 
by the operand 4 value. This operand is formed using 
the packed fixed-point decimal format. 


The second operand specifies the decimal significand, 
and occupies a maximum of 16 bytes of storage as 
specified by the operand 4 value. This operand is 
formed using the packed fixed-point decimal format. 


The third operand, bits 8 through 11, specifies an 
options mask to control the conversion operation. 


Bits Meaning 


8 Mode of rounding to be performed. 
O = Round using current float rounding 


mode in effect. 
1 = Round using decimal round 


algorithm. 


9-11 Reserved. 
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The fourth operand, halfword register hex F, contains 
the digit lengths of the first and second operands. The -) 
total number of digits for operand 1 is contained as a 

value between 5 and 31 in the leftmost byte of the 

halfword register. The total number of digits for 

operand 2 is contained as a value between 1 and 31 in 

the rightmost byte of the halfword register. The 

specified digit lengths must be within the allowable 

ranges, or a specification exception is signaled. The 

length of operands 1 and 2 (in bytes) is calculated by 

dividing the total digit count by 2 and adding 1 to the 

resulting quotient. The number of digits specified are 

considered right adjusted in their respective fields. An 

even-value digit length indicates the leftmost digit 

position of the packed field is not to be considered a 

digit position of the corresponding operand value. 


The fifth operand, base register hex E, specifies the 
address of the binary floating-point number. The 
number occupies 4 bytes, and has the short 
floating-point field format. 


The exponent (operand 1) and significand (operand 2) 
contain a decimal form of a floating-point number. The 
value of this number is: 


Value = M * (10**E) ) 
where: 


M = the value of the significand operand 
E = the value of the exponent operand 
** denotes exponentiation 

* denotes multiplication 


The exponent is formed as a decimal integer value. The 
exponent, which gives the floating-point value its 
magnitude, contains a signed integer value that specifies 
a power of 10. The exponent has an assumed decimal 
point immediately to the right of its rightmost digit 
position. 


The significand is formed as a decimal value with a 
single integer digit in its leftmost digit position and 
fractional digits in the digit positions to the right of the 
integer digit. The significand contains a signed decimal 
value that specifies decimal digits to give the 
floating-point value its precision. The significand has an 
assumed decimal point immediately to the right of its 
leftmost digit position. 


The binary floating-point source is converted to a 
decimal form floating-point value as if to infinite 
precision. However, the precision provided for by 
floating-point fields is not as great as the precision 
provided for by decimal fields. Short floating-point 
provides for unique representation of a maximum of 7 
significant decimal digits of precision. The significant 
digits of the significand start with the leftmost nonzero 
decimal digit and continue to the right out to the end of 
the significand value. The converted significand value is 
formed as a normalized value, the significant digits are 
left adjusted in the converted value, and the converted 
exponent is set accordingly. Significand digits beyond 
the leftmost 7 provide for uniqueness of the conversion 
and should be considered only as precise as the 
floating-point calculations that produced the sourve 
value. 


The converted significand value is adjusted to the 
precision of the significand operand, if necessary, by 
using the rounding algorithm specified in the options 
mask operand. If the rounding algorithm causes a carry 
out of the leading integer digit position, the converted 
rounded significand value is shifted right one digit 
position and the converted exponent incremented by one 
to realign the significand back to having one leading 
integer digit. If floating-point rounding is selected, 
rounding is performed according to the current 
floating-point rounding mode in effect. If decimal 
rounding is selected, the current floating-point rounding 
mode is overridden and the decimal round algorithm is 
performed. In this case, a value of 5 is added to the 
converted significand in the leftmost digit position not 
provided for in operand 2, and that digit, and those 
digits to the right of it are truncated from the resulting 
significand value. 


The result of this conversion is then assigned to the 
exponent and significand operands. For an exponent or 
significand operand with an even number of digits, the 
leftmost digit position of the packed field in the operand 
is set to binary O. 


If the binary floating-point number being converted 
contains a value of 0, the exponent operand is set to 
positive 0, and the significand operand is set to O with 
the sign of the binary floating-point number. A positive 
O is set with the preferred positive sign of hex F. A 
negative O is set with the preferred negative sign of hex 
D. 


A decimal overflow exception cannot occur on the 
assignment of the exponent significand values. 


When the binary floating-point number being converted 
contains a denormalized floating-point value, the first 
and second operand values are set with the correctly 
converted and rounded values; no exception is signaled. 
When an infinity or NaN value is encountered in the 
second operand, the invalid floating-point conversion 


exception is signaled and the instruction operation is 
suppressed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlap between operands 1 and 2 is unpredictable. 


Program Exceptions: 


Address translation 

Addressing 

— Effective address overflow 
Invalid floating-point conversion 
Specification 
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Programming Note: The following is a summary of CVSFDF Example 


results for various combinations of operands. 
Receivers Source AE C 064 O7E 


O Bits 8 12 16 20 32 36 47 
-0*10**+0 -0 

Assembler: CVSFDF D,(B,), D,(B,),M 
401040 +0 a a 
-M*10*#*+E -R<-1 Machine: AEOC 2064 207E 
SMNTOSE: RRP A B, (2) and B, (2): 800D OCOO 0000 
-M*10**-E — -R>-1 


B(E): 800D 0CO00 0300 
+M*10**-E +R<1 


IFPC +INF R(F): 070F 

ee nian Storage — Before 
IFPC UNaN 

Legend: 800D OCO0O 0064 


800D OCOO 007E 
R = a real nonzero, nondenormal 


: . XXXX XX 
floating-point number 


800D OCOO 0300 405E C000 








E = the exponent, a nonzero decimal 
number 
M = the significand, a nonzero decimal 
number Storage — After 
MNaN = a masked NaN 
UNaN = __ an. unmasked NaN 800D 0C00 0064 
Geked 800D OCOO 007E 
INF = infinity 
= invalid floating-point conversion 
ee De eee eee 800D 0C00 0300 
exception 
denotes exponentiation 
: denotes multiplication 
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CONVERT SHORT FLOAT TO PACKED DECIMAL 
(CVSFPD) 


Instruction Description 


The value of the second operand is converted from 
floating-point to packed decimal, and the result is 
placed in the first operand location. 


Format: SS 


mialel 0, |e) 
8 


0 Bits 12 16 20 32 36 47 


Operation: The first operand occupies up to 16 bytes of 
storage, as specified by the operand 4 value, and is 
formed according to the packed fixed-point decimal 
format. 


The second operand occupies 4 bytes, and has the short 
floating-point field format. 


The third operand, bits 8 through 11, specifies an 
options mask to control the conversion operation. 


Bits Meaning 


8 Mode of rounding to be performed. 


O = Round using current float rounding 


mode in effect. 
1 = Round using decimal round 


algorithm. 


9-11 Reserved. 


The fourth operand, halfword register hex F, contains 
the total, and the fractional digit count information for 
the number of decimal digits contained in the first 
operand. The total number of digits for operand 1 is 
contained, as a value between 1 and 31, in the leftmost 
byte of the halfword register. The number of fractional 
digits for operand 1 is contained as a value between O 
and 31, in the rightmost byte of the halfword register. 
The specified digit lengths must be within the allowable 
ranges or a specification exception is signaled. The 
number of integer digits in operand 1 is determined by 
subtracting the fractional digit count from the total digit 
count. The length of operand 1, in bytes, is calculated 
by dividing the total digit count by 2 and adding 1 to the 
resulting quotient. The number of digits specified are 
considered right adjusted in the operand 1 field. An 
even-value digit length indicates the leftmost digit 
position of the packed field is not to be considered a 

digit position of the operand value. 


The floating-point value is converted to a fixed-point 
packed decimal number as if to infinite precision. 
However, the precision provided by floating-point fields 
is not as great as that which can be provided by decimal 
fields. Short floating-point provides for unique 
representation of a maximum of 7 significant decimal 
digits of precision. The leftmost nonzero digit of the 
converted packed decimal number is the start of the 
significant digits of the number. Significant digits 
produced in the first operand beyond the first 7 for 
short floating-point provide for uniqueness of 
conversion and should be considered only as precise as 
the calculations that produced the floating-point 
number. 


The result of this conversion is then rounded, if 
necessary, to match the fractional precision of the 
operand 1 field. The rounding algorithm performed is 
controlled by the third operand mask vaiue. If 
floating-point rounding is selected, rounding is 
performed according to the current floating-point 
rounding mode in effect. If decimal rounding is selected, 
the current floating-point rounding mode is overridden 
and the decimal round algorithm is performed. In this 
case, a value of 5 is added to the converted number in 
the leftmost digit position not provided for in operand 1, 
and that digit, and those to the right of it, are truncated 
from the resulting sum. 
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The converted and rounded result is then assigned to 
operand 1 in the fixed-point packed decimal format for 
the number of digits specified by the total digit count 
for operand 1. If any even number of digits was 
specified, the leftmost digit position of the packed 
operand 1 field is set to binary O. 


lf the converted and rounded result is O, the first 
operand value is set to O, and the sign is set positive, 
regardless of the sign of the second operand. 


When a denormalized floating-point value is converted 
from the source operand, the first operand is set with 
the correctly rounded value, and no exception is 
signaled. 


When any nonzero integer digits are truncated on the 
left in assigning the converted and rounded result to 
operand 1, or when an infinity value or a NaN value is 
encountered in the second operand, the invalid 


floating-point conversion exception is signaled, and the 
instruction operation is suppressed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. 


Program Exceptions: 


Address translation 

Addressing 

Effective address overflow 
Invalid floating-point conversion 
Specification 
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Programming Note: The following is a summary of the 


results for various combinations of operands. 3 
Receiver Source 

+0 +RO 

-D -R 

+D +R 

IFPC +INF 

IFPC MNaN 

IFPC UNaN 

Legend 

R a real nonzero value converted and 


RO 


MNaN 
UNaN 
INF 
IFPC 


rounded form of the source 
floating-point number 


a real zero value converted and 
rounded form of the source 
floating-point number 


a nonzero decimal number 

a masked NaN 

an unmasked NaN 2 
infinity 

invalid floating-point conversion 

exception 


The assignment of a real number, R, as the value of the 
decimal field, D, is. only successful if R is a value that 
can be contained within the value range of the decimal 
field; otherwise, an invalid floating-point conversion may 


result. 


C 


CVSFPD Example 
Op E B, D, B. D, 
AE A | 2 068 2 060 
0 Bit 8 12 16 20 32 36 47 
Assembler: CVSFPD D, (B,), D,(B,), M3 
Machine: AEOA 2068 2060 
B,(2) and B,(2): 800D OCOO 0000 
R(F): 0703 


Storage — Before 

0/8 2/A 

800D OCOO 0068 XXXX XXXX 
800D OCOO 0060 405E coood 





Storage — After 
0/8 2/A 


800D OCOO 0068 0003 480F 
800D OCOO 0060 405E cCcoo0o 





Instruction Descriptions 


10-149 


CONVERT SHORT TO LONG FLOAT (CVSLF) 


Instruction Description 


The value of the second operand is converted from the 
short floating-point format to the long floating-point 
format, and the result is placed in the first operand 
location. 


Format: SS 


7ie| oo || 
8 12 


O Bits 16 20 32 36 47 


Operation: The first operand occupies 8 bytes in storage 
and is formed using the long floating-point field format. 


The second operand occupies 4 bytes in storage and 
has the short floating-point field format. 


When the second operand contains a normalized 
nonzero floating-point value, the significand value from 
the second operand is padded on the right with O bits to 
the long floating-point format significand length. The 
biased exponent value of the second operand is 
adjusted to the correct biased exponent value for the 
long floating-point format. This converted floating-point 
value is then assigned to the first operand according to 
the long floating-point field format. The sign bit value 
of operand 2 is assigned to the sign bit for operand 1. 


When the second operand contains a value of O, the 
first oprand is assigned a zero value of the same sign. 


When the second operand contains an infinity 
floating-point value or a masked NaN value, the 
exponent is padded on the right with 1 bits to the long 
floating-point format exponent length, and the 
significand is padded on the right with O bits to the long 
floating-point format significand length. The padding 
occurs prior to their assignment into operand 1. The 
sign bit value of operand 2 is assigned to the sign bit 
for operand 1. 
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When the second operand contains an unmasked NaN 
value, the floating-point invalid operand condition is 
detected. For the case where the floating-point invalid 
operand condition is detected. For the case where the 
floating-point invalid operation exception is masked, 
operand 1 is assigned with a masked NaN value with 
the fraction value from the original unmasked NaN 
padded with zeros on the right out to the long 
floating-point format fraction length. 


When the second operand contains a denormalized 
floating-point number, the result field is assigned the 
correctly converted and normalized value, and no 
exception is signaled. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Floating-point invalid operand 
Specification 








CVSLF Example 
Op E D, B, D, 
AE 7 040 2 060 
0 Bit 8 12 16 20 32 36 47 
Assembler: CVSLF D, (B, ), Dz (Bz ) 
Machine: AEO7 2040 2060 
B,(2) and B, (2): 800D OCOO 0000 


Storage — Before 
0/8 2/A 


800D OCOO 0040 XXXX XXXX 
800D OCOO 0060 405E cooo 





Storage — After 
0/8 2/A 


800D OCOO 0040 400B Ds0o0o 
800D OC00 0060 405E cCoo0o 
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CONVERT SNA TO CHARACTER (CVTSC) 


Instruction Description 


The operation converts the data at the second operand 
location from SNA (systems network architecture) 
compressed format. The conversion is controlled by 
information whose address is in the base register 
specified in the third operand. The result is placed in 


the first operand. 


The operands are as follows: 


Operand 


1 
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Description 


The base and displacement for the 
starting address of the result string 
that is to contain the converted data. 


The base and displacement for the 
starting address of the source string 
that contains the data to be 
converted. 


The base register that contains the 
address of the control information for 
the conversion operation to be 
performed. 


Halfword register 14 specifies the 
length of the first operand (result 
string). A length of zero causes a 
specification exception. 


Halfword register 15 specifies the 
length of the second operand (source 
string). A length of zero causes a 
specification exception. 


The controls operand is a 14-byte string with an 
optional extension that specifies additional information 
to control the conversion operation. The controls 
operand has the following format: 



























Bytes 


9-10 
11 
12-13 
0-63 


Uncon- 
. Prime verted Offset 
Receiver SGuvee oe Receiver |Record verted Gunceaisn Rrrre to 
Offset Offset oh jas MeCOIVEE | ig parency Translate 
odifier Record String Table 


Record 
Separator 
Translate 
Table 






Uncon- 











































































Bytes Bytes 





12 14 


2 Bytes 4 5 6 7 8 9 11 











63 
er Upon input to the instruction, the result offset and the 
Description 
source offset fields specify the offsets at which bytes of 
the source field are processed and entered into the 
Receiver offset 
result field. The source and result offset fields are set to 
Source offset values which indicate how much of the conversion is 
’ a i ti is int 
Algorithm modifier complete when the instruction is interrupted or 
complete. An offset beyond the end of the related 
Receiver record length source or resultant operand causes a specification 
exception. 


Record separator character 

Prime compression character 
Unconverted receiver record bytes 
Conversion status 

Unconverted transparency string bytes 
Offset to translate table 


Record separator translate table 
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The modifier has the following valid values: 


Bits Meaning 
0 Decompression. 
O0= Do not perform decompression. 


1 Perform decompression. 
1-2 Processing Mode. 


00 


String processing if bits 3 or 4 = 
00; record processing if bits 3 
or 4 # 00. No record separators 
in source. Do not perform blank 
padding; do not perform data 
transparency conversion. 


01 = Reserved. 

10 = Record processing. Record 
separators in source. Do blank 
padding; do not perform data 
transparency conversion. 

11 = Record processing. Record 
separators in source. Do blank 
padding; perform data 
transparency conversion. 

3-4 Record Separator Processing. 

00 = Do not put record separators 
into receiver. 

01 = Move record separators from 
source to receiver. (Allowed 
only if bit 1 = 1.) 

10 = Translate record separators from 
source to receiver. (Allowed 
only if bit 1 = 1.) 

11 = Move record separator from 
controls to receiver. 

5-7 Reserved. Must be zero. 


An invalid modifier results in a specification exception. 
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The receiver record length specifies the fixed length for , 
each record stored into the receiver. This length does J 
not include the record separator character. A value of 

zero results in a specification exception. This parameter 

is used in record processing mode only; it is ignored in 

string processing mode. 


The record separator character specifies the character 
that is to precede the converted form of each record in 
the receiver. It can have any value. 


This parameter is used where: 
e A missing record separator is detected in the source. 


e The move record separator from controls to receiver 
function is specified (algorithm modifier bits. 3-4). 


The prime compression character specifies the prime 
compression character for decompression purposes; it 
can have any value. This parameter is ignored if 
decompression is not specified in the algorithm modifier. 


The unconverted receiver record bytes specifies the 

number of bytes remaining in the current receiver record 

that have not been set with converted bytes. This 

parameter is ignored in string processing mode. In J 
record processing mode, the following meanings apply. 


e At start of execution: 

— A value of hex 00 means this is the start of a new 
record and the initial conversion step has not yet 
been performed; if a record separator is supposed 
to be placed into the receiver, this has not yet 
been done. 

— A nonzero value less then or equal to the receiver 
record length specified the number of bytes 
remaining in the current receiver record that have 
yet to be set with converted bytes. Validity is 
assumed and not checked. This value is used to 
determine the location of the next record boundary 
in the receiver. A specification exception occurs if 
this value is greater than the receiver record 
length. 


e At end of execution: 
— This field is set equal to the number of bytes in 
the current receiver record not yet containing 
converted data. 





The conversion status contains information for 
checkpointing the conversion status over successive 
executions of the instruction. It is set to the appropriate 
value at instruction termination. Bit definitions are: 


Bits Meaning 
0 O= No transparency string active. 
1 = Transparency string active. The 


unconverted transparency string 
bytes value contains the remaining 
string length. 


1-15 Reserved. Must be zero. 


The unconverted transparency string bytes specifies the 
number of bytes remaining to be converted for a 
partially processed transparency string. 


If do not perform data transparency conversion is 
specified, this parameter is ignored. 


When perform data transparency conversion is specified, 
this parameter has the following meanings: 


« At start of execution: 

— When the conversion status byte indicates no 
transparency string active (bit O = 0), this value is 
ignored. 

— When the conversion status byte indicates 
transparency string active (bit O = 1), this value is 
a count of the remaining bytes to be converted for 
a transparency string in the source. Validity of this 
count is assumed; it is not checked. 

— A value of hex OO means the count field for a 
transparency string is the first byte to be 
processed from the source. 

— A value of hex 01 through hex FF specifies the 
count of the remaining bytes to be converted for a 
transparency string. 


e At end of execution this parameter is set, along with 
transparency string active, to describe a partially 
converted transparency string. 

— A value of hex OO is set if the count field is the 
next byte to be processed for a transparency 
string. 

— A value of hex 01 through hex FF (specifying the 
number of remaining bytes to be converted) is set 
if the count field has already been processed. 


The offset to translate table specifies the offset from the 
beginning of the controls operand to the record 
separator translate table. This parameter is ignored 
unless the translate record separators from source to 
receiver function is specified. 


The record separator translate table provides for 
translation of the source record separator values being 
placed into the receiver. 


This table is assumed to be 64 bytes in length and 
provides for translation of record separator values from 
hex 00 through hex 3F. 


This table is used only when translate record separators 
from source is specified. 


Format: SS 


jee jel 7 |e} o |e) o 
8 12 


0 Bits 16 20 32 36 47 


Operation: The operation begins by accessing the bytes 
of the source operand at the location specified by the 
source offset. The data is converted and stored in the 
receiver according to the following modes and optional 
functions. 


String Processing Mode 


String processing occurs when algorithm modifier bits 1, 
3, and 4 are all equal to zero. The bytes accessed in the 
source are converted, decompressed (algorithm modifier 
bit O must be equal to one), and then stored in the 
receiver. 
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Decompression 


The decompression function is always performed in 
string processing mode. This function converts strings 
of duplicate and nonduplicate characters in the 
compressed format back to their full length in the 
receiver. Decompressed data is built by concatenating 
one or more character strings as described by the 
compression strings in the source. If necessary, the 
processing of a partial decompressed record is 
performed. 


Each character string to be built in the receiver is 
described in the source by a compression string. 
Compression strings are comprised of an SCB (string 
control byte) followed by prescribed bytes of data 


related to the character string to be built in the receiver. 


The SCB has the following format and bit definitions: 


Bits Meaning 


0-1 Control. 


00 = n nonduplicate characters are 
between this SCB and the 
next one. n is the value in 
the count field; possible 
values are 1-63 (decimal). 


Ul 


01 Reserved. 


HT 


10 This SCB represents n 
deleted prime compression 
characters. n is the value in 
the count field; possible 
values are 1-63 (decimal). 
The next byte is the next 


SCB. 
11 


This SCB represents n 
deleted duplicate characters. 
n is the value of the count 
field; possible values are 
1-63 (decimal). The next 
byte contains a specimen of 
the deleted characters. The 
byte following the specimen 
character contains the next 
SCB. 
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Bits Meaning J 


2-7 Count. 


The value n (in binary) in this field 
represents the count of the number of 
characters that have been deleted for a 
prime compression character string, a 
duplicate character string, or the number 
of characters to the next SCB for a 
nonduplicate string. A count value of 
zero is invalid and causes a conversion 
exception. 


Strings of prime compression characters or duplicate 
characters described in the source record are repeated 
in the decompressed character string the number of 
times indicated by the SCB count value. 


Strings of nonduplicate characters described in the 
source record are formed into a decompressed character 
string for the length indicated by the SCB count value. 


If the end of the source is encountered prior to the end 
of a compression string, a conversion exception is 
signaled. 


C 


In string processing mode: 


« Decompression is performed on a compression string 
basis with no record oriented processing implied. The 
conversion process for each compression string is 
completed by placing the decompressed character 
string into the receiver. 


e The conversion process continues until the end of the 
source or receiver is reached. 

— When the end of the source is encountered, the 
instruction ends with a source exhausted condition 
code. 

— When the end of the receiver is encountered, the 
instruction ends with a receiver overrun condition 
code. 

— For either of the previous ending conditions, the 
controls operand is updated to describe the status 
of the conversion operation as of the last 
completely converted compression entry. Partial 
conversion of a compression entry is not 
performed. 


Record Processing Mode 


Record processing occurs when bit 1, bit 3, or bit 4 is 
equal to one in the algorithm modifier. Source bytes are 
accessed, converted, and placed into the receiver on a 
record basis. 


The source offset locates the point at which processing 
should start on a full record or the point at which 
processing should be resumed on a partial record. If the 
unconverted receiver record bytes value is zero, source 
offset points to the start of a full record. If the 
unconverted receiver record bytes value is nonzero, 
source offset points to the location where processing of 
a partial record should be resumed. For resumption of 
processing of a partial record, the value in the 
conversion status byte indicates whether or not a 
transparency string is active. 


The conversion process is started by completing the 
conversion of a partial source record, if necessary, 
before processing the first full source record. 


A check is made (before storing the first byte of each 
record), to see if the receiver has room for another full 
record. If not, a receiver overrun condition is recognized 
and the instruction is terminated; the controls operand is 
updated to describe the last completely converted 
record. Partial conversion of a source record is not 
made. Source data is accessed prior to this check and 
this may result in a source exhausted condition or a 
conversion exception. 


Record Separator Conversion 


The record separator conversion function is always 
performed in record processing mode. This function can 
be performed with, or without, the optional 
decompression, data transparency conversion, and blank 
padding functions. 


In record processing mode, a record separator is 
recognized in the source when a character value less 
than hex 40 is encountered; however, if decompression 
is not specified (algorithm modifier bit O = 0), a 
character whose value is hex OO is ignored. If the 
perform data transparency conversion function is also 
specified (algorithm modifier bit 2 = 1), a character value 
of hex 35 is recognized as the start of a transparency 
string instead of a record separator. 
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This function controls the conversion of record 
separators into the receiver. The four possible options 
are (refer to algorithm modifier bits 3-4 definitions): 


e Put no record separators in receiver; any record 
separator found in the source data is ignored and not 
placed into the receiver. 


e Move record separators from source to receiver; any 
record separator found in the source is left as is and 
placed into the receiver. 


e Translate record separators from source to receiver; 
the record separator from the source is translated via 
the translate table. The translated value is placed into 
the receiver as follows: 

— The translation is performed as in the Translate 
instruction. The source record separator value is 
used as an index into the translate table; the value 
at that location in the table (if not hex FF) is 
placed into the receiver as a record separator. 

— If the indexed translate table byte is equal to hex 
FF, it is recognized as an escape code and the 
instruction ends with an escape code encountered 
condition code. The controls operand is set to 
describe the conversion status as of the 
processing completed just prior to the conversion 
step for the record separator. 


e Move record separator from controls to receiver; 
when a record separator is found in the source, the 
record separator value specified in the controls 
operand is placed in the receiver. 
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Missing Record Separator Handling: During the initial J 
processing for a full record, the controls record 

separator character is used as the record separator value 

in the receiver and the specified record separator 

conversion function is not performed if all of the 

following conditions exist: 


e The first byte of data is not a record separator 


« Record separators are expected in the source 
(algorithm modifier bit 1 = 1) 


e Record separators are to be placed in the receiver 
(algorithm modifier bits 3 or 4 = 1) 


Data Transparency Conversion 


The data transparency conversion function is performed 
only in record processing mode (along with blank 
padding); decompression can be performed with this 
function, but is not required. 


This function correctly identifies record separators in the 
source even though the data has value that could be 
interpreted as record separators. 


The source data is converted and stored into the J 
receiver and is not transparent to the scan for a record 

separator value unless data transparency conversion is 

specified, and a source byte with hex 35 value is 

detected. Detection of this combination indicates a 

transparency string; source data transparent to record 

separator scanning is converted. 


The hex 35 byte is the first byte of a 2-byte 
transparency control field (TRN). The second byte is a 
hexadecimal count (with allowable values of 1-255) that 
specifies the number of following bytes to be treated as 
transparent data. A transparency count of zero causes a 
conversion exception. This transparent data is not 
scanned for record separators. Only the transparent 
data is moved to the receiver; the TRN bytes are not 
moved. 


A record in the receiver can be a mix of converted 
transparent and non-transparent source data; the first 
byte is always a record separator unless the algorithm 
modifier bits 3 and 4 specify do not put record 
separators into receiver (algorithm modifier bits 3 and 4 
= 00). 


If conversion continues until the length of converted 
data equals the specified receiver record length, the 
record is complete. An active transparent string is then 
handled as described in the definition of the 
unconverted transparency string bytes parameter. 


Partial record processing is performed as described in 
the definition of unconverted receiver record bytes 
parameter. 


Missing record separator and record separator 
conversion are performed as previously described. 


If the end of source is encountered before the record is 
completed, the controls operand is updated to describe 
the partially converted record (and the partially converted 
transparency string, if appropriate), and the instruction 
ends with a source exhausted condition code. 


Blank Padding 


The blank padding function is performed in record 
processing mode along with record separator 
conversion. Decompression and data transparency 
conversion can be performed with this function, but are 
not required. 


This function pads a receiver record with blanks to the 
size specified by the receiver record length. The padded 
blanks replace the trailing blanks truncated by the 
Convert Character-to-SNA instruction. The padded 
record can be produced from a partial or full record 
from the source. 


The record separator for this record is accessed. 
Missing record separator and record separator 
conversion are performed as previously described. 


Blank padding occurs if another record separator is 
detected before enough data has been processed to 
equal the receiver record length. Blanks are added to 
make the length of the converted data equal the receiver 
record length. 


If the end of the source is encountered instead of 
another record separator, the data processed up to that 
point is placed into the receiver (no blank padding is 
done). The instruction ends with a source exhausted 
condition code. The controls operand is updated to 
describe the status of the partially converted record. 


Decompression 


The decompression function is performed one record at 
a time. 


A conversion exception is signaled if a compression 
string describes a character string that would span a 
record boundary in the receiver. 


Specified record separator conversion is performed as 
the first step (after decompression); missing record 
separators are handled as described under Record 
Separator Conversion. 


The specified receiver record length applies to converted 
data only; it does not include a record separator. 


Decompression continues until one of the following 
conditions occur: 


« A record separator character for the next record is 
recognized and the source contains record separators 
is specified. 


e The amount of decompressed data required to fill the 
receiver record has been processed. 


e The end of the source is encountered. 


Transparency strings encountered are not scanned for a 
record separator value. 


The decompressed character strings, appended to the 
optional record separator for this record, form the 
decompressed record. If the end of the source is 
encountered, the data decompressed to that point, 
appended to the optional record separator for this 
record, forms a partial decompressed record. 
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Instruction Termination 


The CVTSC instruction terminates in one of the 
following ways: 


e The end of source operand is reached. This results in 
a source exhausted condition code. 


« The end of the receiver is reached. This results in a 
receiver overrun condition code. 


¢ A hex FF value is encountered in the record separator 
translate table. This results in a escape code 
encountered condition code. 


At the completion of instruction execution: 


« The source offset and receiver offset parameters are 
updated to point to the next bytes to be operated on 
in the source and receiver, respectively. 


« If record processing is specified, the unconverted 
receiver record bytes parameter is updated to specify 
the number of bytes remaining in the current receiver 
record that have yet to be set. 


¢ If perform data transparency conversion is specified, 
the conversion status byte is appropriately set, and 
the unconverted transparency string bytes are 
updated to describe the partially converted string. 


Any form of overlap between the operands of this 
instruction yields unpredictable results. 
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Programming Notes 


The CVTSC instruction does not provide support for 
compression entries in the source describing data that 
would span records in the receiver. SNA data from 
some systems may violate this restriction and, as such, 
be incompatible with this instruction. A provision can be 
made to avoid this incompatibility by performing the 
conversion through two invocations of this instruction. 
The first invocation would specify just decompression, 
with no record separator processing. The second 
invocation would specify record separator processing 
with no decompression. This technique separates the 
two functions, thus avoiding the incompatibility. 


When decompression is not performed and the source is 
specified to contain record separators, source bytes of hex 00 
are ignored. They are not transferred to the receiver and are 
not treated as record separators. When decompression is 
specified, source bytes of hex 00 are not ignored. If the 
source contains record separators and decompression is 
specified, source bytes of hex OO are considered to be record 
separators. 


This instruction can end with the escape code 
encountered condition. In this case, it is expected that 
the user of the instruction will do some special 
processing for the record separator causing the 
condition. In order to resume execution of the 
instruction, the user will have to set the appropriate 
value for the record separator into the receiver and 
update the controls operand offset values correctly to 
provide for restarting processing at the right points in 
the receiver and source operands. 


For the special case of a tie between the source 
exhausted and receiver overrun conditions, the source 
exhausted condition is recognized first because when 
source exhausted is the resultant condition, the receiver 
may also be empty. In this case, the offset into the 
receiver operand may contain a value equal to the length 
specified for the receiver which would cause an 
exception to be detected on the next invocation of the 
instruction. The processing performed for the source 
exhausted condition should provide for this case, if the 
instruction is to be invoked multiple times with the same 
controls operand value. When the receiver overrun 
condition is the resultant condition, the source will 
always have room for the conversion. 


This instruction is interruptible. If interrupted, 
information required to continue is stored in the controls 
operand the the instruction address register points to 
the instruction so that processing continues after the 
interrupt. 


J 


J 


Overflow and Sign Code: Not applicable.’ 


Condition Codes: 


Source Exhausted 
Receiver Overrun 


QhNH— © 


Escape Code Encountered 


Carry: Not applicable. 


Boundary Requirernents: None. 


Program Exceptions: 


Address translation 
Addressing 

Conversion 

Effective address overflow 
Specification 


CVTSC Example 

Op E D, D, 

BE 7 6A8 644 
O Bits 8 12 16 20 32 36 47 
Assembler: CVTSC D,(B,), D,(B,), Bs 
Machine: BED7 36A8 4644 
B, (3): 0001 236A O000 (Base register for result) 
B.(4): 0001 136A OO00 (Base register for source) 
B3(13): 0001 036A OO000 (Address of control operand) 
R(14): OO0A (Length of result) 
R(15): OOOC (Length of source) 


Storage — Before 


0001 036A 0000 
0001 136A 0644 


0001 236A 06A8 





Storage — After 


0001 036A 0000 


0001 136A 0644 


0001 236A 06A8 





Before After 
Condition Code: x 1 
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CONVERT ZONED TO PACKED (CVZP) 
Instruction Description 
The format of the second operand is changed from 


zoned to packed and the result is placed in the 
first-operand location. 


Format: SS 
(6 [uiots| o, |e| o, _ 
O Bits 12 16 20 32 36 47 


Operation: The second operand is assumed to have the 
zoned format. All zones are ignored, except the zone 
over the rightmost digit, which is assumed to represent 
a sign. The sign is placed in the right 4 bits of the 
rightmost byte and the digits are placed adjacent to the 
sign and to each other in the remainder of the result 
field. The sign and digits are moved unchanged to the 
first-operand field and are not checked for valid codes. 


The result is obtained as if the fields were processed 


right to left. If necessary, the second operand is 
logically extended to the left with zeros. 


Overflow: If the first-operand field is too short to 


contain all significant digits of the second-operand field, 


decimal overflow occurs and the leftmost significant 
digits are lost. 


Sign Code: See Operation. 


Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements: The operands can overlap if the 

rightmost byte of the first operand is coincident with or J 
to the right of the rightmost byte of the second 

operand; otherwise, the overlap is destructive and the 

results are unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Decimal overflow 
Effective address overflow 


CVZP Example 


Op B. 
F6 1 a 3 


O Bits 16 20 32 36 47 
Assembler: CVZP D,(L,, B,)}, Dz (L2, By} 
Machine: F647 3124 3154 


B, (3) and B, (3): 2881 5655 1000 


Storage — Before J 


2881 5665 1124 


XX 


2881 5665 1154 
F8F9  F4F2 





Storage — After 


2881 5665 1124 
2F 


2881 5665 1154 


F8F9  F4F2 





CONVERT ZONED TO PACKED WITH DATA 
CHECKING AND BLANK CONVERSION (CVZPB) 
Instruction Description 

The format of the second operand is changed from 


zoned to packed and the result is placed in the 
first-operand location. 


Format: SS 





O Bits a i ic 20 ay 36 


Operation: The second operand is assumed to have the 
zoned format. All zones are ignored, except the zone 
over the rightmost digit, which is assumed to represent 
a sign. The updated sign is placed in the right 4 bits of 
the rightmost byte and digits are placed adjacent to the 
sign in the remainder of the result field. The sign and 
digits are checked for valid codes. If the rightmost byte 
of the zoned operand is hex 40, it is considered to have 
a valid plus sign. If the sign of the zoned operand is 
positive, the preferred sign of 1111 is used. If the sign 
of the zoned operand is negative, the preferred sign of 
1101 is used, unless the digits are all zero, then a sign 
of 1111 is used. 


The result is obtained as if the fields were processed 
right to left. If necessary, the second operand is 
logically extended to the left with zeros. 


The length of each operand is in digits. When the digit 
count of the first operand is even, the first four bits of 
the leftmost byte are set to zero. 


Overflow: If the first-operand field is too short to 
contain all significant digits of the second operand field, 
decimal overflow occurs and the leftmost significant 
digits are lost. 


Sign Code: See Operation. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
rightmost byte of the first operand is coincident with, or 
to the right of the rightmost byte of the second 
operand; otherwise, the overlap is destructive and the 
results are unpredictable. 


Program Exceptions: 


— Address translation 

— Addressing 

— Data 

— Decimal overflow 

— Effective address overflow 


CVZPB Example 





O Bit 8 12 16 20 32 36 47 


Assembler: CVZPB D, (L;, B,), D2(L2, Bz) 
Machine: D677 3124 3154 
B, (3) and B, (3): 2881 5655 1000 


Storage — Before 


2881 5665 1124 
XX 


2881 5665 1154 
F8F9 F4F2 





Storage — After 


2881 5665 1124 
2F 


2881 5665 1154 


F8F9 F4F2 





Instruction Descriptions 10-162.1 


CONVERT ZONED TO PACKED WITH DATA Boundary Requirements: The operands can overlap if the 

CHECKING (CVZPC) rightmost byte of the first operand is coincident with J 
or to the right of the rightmost byte of the second 
operand; otherwise, the overlap is destructive and the 

Instruction Description results are unpredictable. 


The format of the second operand is changed from 
zoned to packed and the result is placed in the Program Exceptions: 
first-operand location. 
— Address translation 
— Addressing 
Format: SS — Data 
— Decimal overflow 


[es Jufife,| o, [elo ~ fective address overfiow 


0 Bits 12 16 20 32 36 47 


CVZPC Example 


Operation: The second operand is assumed to have the 
zoned format. All zones are ignored, except the zone a é 
over the rightmost digit, which is assumed to represent L 4 


a sign. The updated sign is placed in the right 4 bits of 0 Bits 12 16 20 32 36 47 
the rightmost byte and the digits are placed adjacent to 
the sign in the remainder of the result field. The sign 
and digits are checked for valid codes. If the sign of the 
zoned operand is positive, the preferred sign of 1111 is 
used. If the sign of the zoned operand is negative, the 


f ; ‘ait ; | 
pre erred sign of 1101 is used, unless the digits are all B, (3) and B, (3): 2881 5655 1000 
zero, in which case a plus sign of 1111 is used. 


Assembler: CVZPC D, (L, ; B, ), D, (L3 ; B, ) 


Machine: E677 3124 3154 


The result is obtained as if the fields were processed Storage eters 
right to left. If necessary, the second operand is 
logically extended to the left with zeros. 

2881 5665 1124 


The length of the operands is in digits. When the digit 
count of the first operand is even, the first four bits of 2881 5665 1154 ? Sis 
the leftmose byte are set to zero. F8F9 4F2 





Overflow: If the first-operand field is too short to 
contain all significant digits of the second-operand field, Storage — After 
decimal overflow occurs and the leftmost significant 
digits are lost. 


2881 5665 1124 
2F 
Sign Code: See Operation. 2881 5665 1154 


F8FQ9  F4F2 


Condition Code: Not changed. 





Carry: Not applicable. 
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DEQUEUE MESSAGE (DQM) 
Instruction Description 


A send/receive message is dequeued from the 
send/receive queue designated by the second operand. 


Format: SS 


8 


O Bits 12 16 20 32 36 47 


Operation: The search type is specified by the |-field. 
The search key, which is treated as unsigned binary 
data, is specified by the third operand and must be of 
the length specified in the queue header. The messages 
searched are accessed sequentially, starting with the 
first message. The first message satisfying the search 
type is dequeued. B, is loaded with the address of the 
dequeued message. If no message satisfies the search 
type, or if the message list is empty, B, is not altered. 


Il-Field Search Type 


Bit 12 Message Key = Search Key 

(the third operand) 
Bit 13. Message Key < Search Key 

(the third operand) 
Bit 14 Message Key > Search Key 

(the third operand) 
Bit 15 Not used 


The search type is the logical inclusive OR of the I-bits 
specified. For a search type of binary 000x, no keys will 
satisfy the search type, therefore, this combination is 
invalid. A specification exception occurs and the 
operation is suppressed. 


Note: A dequeue first operation is accomplished by 
setting the |-field to binary 111x. In this case, any 
search key provides the desired operation. However, 
because the third operand is accessed and used in the 
comparison, it is convenient to specify the third operand 
(the search key) as the header address to eliminate a 
potential address translation exception. The hardware 
forces a zero for the length field in the header and the 
key value is ignored for specifications of | = binary 111x. 
Also, a check is not made for a page crossing in the key 
field if enqueue first or enqueue last is specified. 
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Overflow and Sign Code: Not applicable. ) 


Condition Code: 


0 One or more messages remaining after 
successful dequeue 

1 No messages remaining after 
successful dequeue 

2 aa 

3 Not dequeued 


Carry: Not applicable. 


Boundary Requirements: The search key specified by the 
third operand must be fullword aligned and cannot cross 
a page boundary. 


Program Exceptions: 


— Address translation 
— Addressing 
— Descriptor access: Busy 
— Descriptor access: Monitored SRM descriptor 
: ; 
— Descriptor access: Monitored SRO descriptor 
— Effective address overflow 


DQM Example 


Op D, 
DA a 000 


O Bits 16 20 32 36 47 


Assembler: DOM B,, D2 (Bz), D3(B3) 
Machine: DA48 5000 6000 

Before After 
Bi (4): xxxx XXXX = XXXX 21A0 1230 0000 
B2(5): 0020 3240 Q000 0020 3240 0000 
B3(6): 0000 EF20 0000 0000 EF20 0000 


Before 




























































First Waiti Key First Message R 
0020 3240 0000 Descriptor . fete Reserved| Lth-1 Address A 
nse 21A0 1230 0000 ied 
Bytes 8 9 A 10 20 
Next Message K 
21A0 1230 0000 Descriptor Address = Message 
67B0 1110 000uU 53 
Bytes 2 8 9 
Next Message Key 
67B0O 1110 0000 Descriptor Address Se Message 
XXXX XXKXX XXX 
Bytes 2 8 9 
After 
: oe First Message 
0020 3240 0000 Descriptor A An Reserved| 0Y | Address dive 
aoe 67B0 1110 0000 ass 
Bytes 2 8 9 A 10 1F 










Next Message 
67B0 1110 0000 Descriptor Address Key Message 
XXXK XXXK XXX 
Bytes 2 8 9 
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DEQUEUE TASK DISPATCHING ELEMENT (DQTDE) 
Instruction Description 

The TDE addressed by the first-operand is dequeued 
from the SRQ (send/receive queue), wait list, SRC 


(send/receive counter) wait list, or TDQ (task 
dispatching queue) designated by the second operand. 


Format: RS 


12 


0 Bits 8 16 20 31 


Operation: No search key is used. 
Overflow and Sign Code: Not applicable. 


Condition Code: 


0 One or more TDEs remaining 
after successful dequeue 

1 No TDEs remaining after successful 
dequeue 

2 = 

3 Not dequeued 
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Carry: Not applicable. ) 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRQ descriptor 

— Descriptor access: Monitored TDE descriptor (if 
the second operand is an SRQ) 

— Effective address overflow 

— Invalid descriptor 

— Specification 


DOTDE Example 


Op |B, D, 
6D 3 000 
O Bits 8 12 16 20 31 
Assembler: DOTDE B,, D2(B2) 
Machine: 6D31 4000 
Before After 
B, (3): 0321 BO31 0000 0321 BO31 0000 


B,(4): 0001 D5C1 0000 0001 D5C1 0000 















Before 
TDQ 
First TDE Address 
0001 D5C1 0000 0321 BO31 0000 
0 2 : 
TDE 
: Next TDE Address 
0321 BO31 O000 0321 BCOO 0000 
0 2 8 
TDE 
. Next TDE Address 
0321 BCOO 0000 XXXX XXXX XXXX 
0 2 8 


After 


0001 D5C1 0000 


TDQ 
Descri tor First TDE Address 
J 0321 BCOO 0000 
8) 
TDE 
Next TDE Address 
Descriptor 
XXXX XXXX XXXX 
0 


0321 BCOO 0000 
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DIAGNOSE (DIAG) 

Instruction Description 

This instruction provides a way to test the |/O channel 
disconnect line by turning off the valid page bit in a 


specified |/O RAR (resolved address register) and a way 
to sample the system power status. 


Format: Sl 


Leo fol7ia) o 
12 


O Bits 8 16 20 31 


Operation: The first operand occupies a fullword in 
storage and has the following format: 


Byte Description 


0 Must be hex 20 or hex 80. 

1 Specified |/O RAR (reserved if byte O is 
hex 20). 

2-3 Reserved. 


|/O RARs begin at VLS (VAT local storage) location hex 
100, so by coding hex B1 in byte 1 of the first operand, 
VLS (1B1) is modified.' 


If byte O does not equal hex 20 or hex 80 or if byte O is 
hex 80 and byte 1 specifies |/O RAR greater than hex 
DF on Models 3, 4, and 5, the operation is suppressed. 
If byte O is hex 80, the valid page bit is reset in the 
specified |/O RAR. The position of the valid page bit is 
indicated below: 


| Model |b 
3,4, and 5 
6 tends 1 


If byte O is hex 20, the system power status is returned 
in base register 5 as follows: 






O = Not valid 

1 = System under utility power 
2 = System under UPS power 
3 = System power fluctuating 


IVLS (1b1) is location 1B1 in the VAT (virtual address 
translator) local storage. The VAT local storage array is used 
to buffer the necessary information required during virtual 
address translation. For additional information see the /BM 
System/38 Processing Unit Theory-Maintenance manuals, for 
Models 3, 4, and 5, SY31-0524, for Model 7, SY31-0649. 
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Overflow and Sign Code: Not applicable. 3 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The first operand must begin 
on a fullword boundary; otherwise, a specification 
exception occurs and the operation is suppressed. 


DIAG Example 


Op E D, 
6D 7 DOO 
12 31 


0 Bits 8 16 20 


Assembler: DIAG D, (B,) 
Machine: 6D07 3D00 


B, (3): OOAF 0210 0000 


Storage — Before and After J 





OOAF 0210 ODOO 


Before After 


VLS (1B1) XXXX EXXX XXXX AXXX 


DISABLE TASK DISPATCHING (DTD) 


Instruction Description 


This instruction disables task dispatching by setting the 
task dispatcher mask (byte hex 22, bit 7 of LSR [local 
storage register ]} off and stops the task interval timer. 
This LSR is in HMC (horizontal microcode). 


Format: RR 


O Bits 8 12 15 


Operation: No other task can be executed until the task 
dispatcher mask is turned on by the Enable Task 
Dispatching instruction. Program exceptions are handled 
by the machine check handler while the task dispatcher 
mask is off. 


A machine check will be reported if a Receive Message, 
Receive Count, Dispatch Task Dispatching Queue, or 
Supervisor Linkage instruction is executed while the task 
dispatcher mask is off. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


Programming Note: When task dispatching is disabled, 
the task interval timer will not be decremented. The 
second interval timer, the clock comparator, and the 
time-of-day clock will continue to function. 


DTD Example 


Op 

OD 
0 Bits 8 12 15 
Assembler: DTD 


Machine: 0D0O1 


The following bit is reset by this instruction: LSR 
byte 22 (F_LGO), bit 7 (flag task switch blocked). 
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DISPATCH TASK DISPATCHING QUEUE (DTDQ) Overflow and Sign Code: Not applicable. 


Instruction Description 


Condition Code: Not changed. 
See Operation. 


Carry: Not applicable. 
Format: Sl 


eo | fel | | Boundary Requirements and Program Exceptions: None. 


0 Bit 8 12 16 20 31 


DTDQ Example 
Operation: If the top TDE (task dispatching element) of 


the TDQ is the current TDE, the following occur: the O 

; : p 
PEM (program event monitor) mode is enabled or 6D 
disabled according to the setting of byte hex C, bit 6 of 
the current TDE; task switch trace is set according to OTR: 6B whee, TRE ee 2 
byte hex C, bit 2; SVLM1 operation is set according to 
byte hex C, bit 3; the SVLM (supervisor linkage mask) 
status is set according to byte hex C, bit 7; and the next 


sequential instruction is executed. Otherwise the task 
dispatcher is invoked. 


Assembler: DTDQ 


Machine: 6DO6 0000 
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DIVIDE HALFWORD STORAGE (DHS) 
Instruction Description 
The dividend (first operand) is divided by the divisor 


(second operand) and replaced by the quotient and 
remainder. 


Format: SS 
O Bits 12 16 20 32 36 47 


Operation: The dividend is a 32-bit signed-binary value 
occupying a word of storage at the first-operand 
location. It is replaced by a 16-bit, signed remainder 
and a 16-bit signed quotient occupying the first and 
second halfwords, respectively. The divisor is a 16-bit 
signed integer. 


When the relative magnitude of the dividend and divisor 
is such that the quotient cannot be expressed by a 
16-bit signed integer, a binary divide exception occurs 
and the operation is suppressed. This includes attempts 
to divide by zero. 


Overflow: Not applicable. 


Sign Code: The sign of the quotient is determined by 
the rules of algebra. The remainder has the same sign 
as the dividend, except that a zero quotient or a zero 
remainder is always positive. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The halfword storage operand 
must start on a halfword boundary and the word storage 
operand must start on a word boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Binary divide 

Effective address overflow 
Specification 


DHS Example 
Op D, 
DD A80 
0 Bits 12 16 20 32 36 47 


Assembler: DHS D, (B,), D2 (Bz) 
Machine: DDOO 3A40 3A80 


B,(3) and B,(3): 3456 BACD 8000 


Storage — Before 


0/8 2/A 
3456 BACD 8A40 0001 1000 
3456 BACD 8A80 0006 





Storage — After 
0/8 2/A 


3456 BACD 8A40 0002 2D55 
3456 BACD 8A80 0006 
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DIVIDE LONG FLOAT (DLF) 


Instruction Description 


The first operand is divided by the second operand 
(two-operand format) or the second operand is divided 
by the third operand (three-operand format), and the 
quotient is placed in the first operand location. No 
remainder is saved. 


Format: SS 


AA 


O Bit 8 12 16 20 32 36 47 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used if base 
register O is specified for the third operand. The 
three-operand format is used if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


Floating-point division uses exponent subtraction and 
significand division. The difference between the signed 
(unbiased) exponents of the dividend and the divisor 
operands is used as the signed exponent of the 
intermediate quotient when both the dividend and the 
divisor are normalized. 


When the dividend is denormalized and the divisor is 
normalized and nonzero, the difference between the 
signed exponents of the dividend and divisor operands 
less 1 is used as the signed exponent of the 
intermediate quotient. 


All dividend and divisor significand digits participate in 
forming the significand of the quotient. The intermediate 
quotient is calculated as if to infinite precision. 


Normalizing the intermediate quotient is never 
necessary, but a right shift of one digit position can be 
called for, which causes the intermediate quotient 
significand to be shifted right one digit position. 


The intermediate quotient is rounded, if necessary, 
according to the rounding mode specified in the task 


dispatching element. 


When the dividend is O and the divisor is a finite 
number or infinity, the quotient is O. 
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If the divisor is denormalized and the dividend is 
normalized and not normal O, an invalid operand ) 
exception is recognized. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
quotient. The source operands are checked for this 
value in order of their specification with the masked 
not-a-number with the larger fraction value being 
provided as the quotient. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 

2 
Sign Code: The sign of the quotient is determined by 
the rules of algebra. This amounts to the exclusive OR 
of the divisor and dividend signs and applies to 
quotients of O or infinity value as well as for normal 
finite results. 


Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: All operands must be fullword 
aligned; otherwise, a specification exception occurs, and 
the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 
— Floating-point inexact result 
— Floating-point invalid operand 

— Floating-point overflow J 
— Floating-point underflow 

— Floating-point zero divide 

— Specification 





C 


Programming Note: The following is a summary of the 
results for various combinations of operands. 


‘Quotient =” First Operand (Divisor) Second Operand (Dividend) 
invalid operand exception 


Divide by zero +Real number # 0 or -real +0 or -0 
number # 0 


+Real number # O 


. ok 
oo eat number xO 
oot Rea number tO 
-Real number # 0 -Larger real number # O 


+Infinity +|nfinity +Real number # 0 


+nfinity +Intinity 


+Infinity - Infinity 














-Real number # O 








+Infinity -Infinity 








- Infinity - Infinity +Real number # O 















- Infinity -Infinity 


lntinty +0 

| -lnfinity infty 
+0 
+0 so ity 
+0 


Note: For a small value real number that is not equal to O and a larger value real number 
that is not equal to 0, a masked floating-point underflow which yields a O rather than a 
denormalized result can occur. 
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J 
of tity 
of Real number #0 infinity 
mo tity 
of Reat number #0 | nfiity 
ott 

Masked not-a-number Not not-a-number 

Masked not-a-number Masked not-a-number 





Larger masked Masked not-a-number Masked not-a-number 
not-a-number | 


Invalid operand exception Unmasked not-a-number Any 
Invalid operand exception Unmasked not a number 


Legend: 


Any = Any floating-point value. 
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C 


DLF Example 
Op D, 
CE O60 
O Bits 8 12 16 20 32 36 47 
Assembler: DLF D,(B,), D2 (B,), B3 
Machine: CE34 4050 4060 
B3(3): 0010 0200 0070 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 
0010 0200 0050 


0010 0200 0060 
0010 0200 0070 





Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Condition Code: Not changed. 
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DIVIDE PACKED (DP) 
Instruction Description 


The dividend (first operand) is divided by the divisor 
(second operand) and replaced by the quotient and 
remainder. 


Format: SS 


rs tutilel 0 |e) 
8 12 


0 Bits 16 20 32 36 47 


Operation: The quotient is placed leftmost in the 
first-operand field. The remainder is placed rightmost in 
the first-operand field and has a length equal to the 
divisor length. Together, the quotient and remainder 
occupy the entire dividend field. 


The dividend, divisor, and remainder are all signed 
integers, right-aligned in their fields. The quotient is a 
signed integer, but is left-aligned in its field. The digit 
codes are checked for validity; invalid codes cause data 
exceptions, and the operation is terminated. 


When division by zero is attempted, a decimal zero 


divide exception occurs and the operation is suppressed. 
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Overflow: When the quotient is larger than the number 
of digits allowed, an overflow occurs and the rightmost 
significant digits are lost. 


Sign Code: The sign of the quotient is determined by 
the rules of algebra from the dividend and divisor signs. 
The remainder has the same sign as the dividend except 
that a zero quotient or a zero remainder is always 
positive. The processor uses the preferred signs for the 
quotient and remainder as follows: a positive sign is 
encoded as 1111 (hex F); a negative sign is encoded as 
1101 (hex D). 


The sign codes are checked for validity; invalid codes 
cause a data exception, and the operation is terminated. 


Condition Code: Not changed. 


Carry: Not applicable. 


J 


Boundary Requirements: The divisor and dividend fields 
can overlap only if their rightmost bytes coincide. 
Improperly overlapping fields cause a data exception, 
and the operation is terminated. 


Program Exceptions: 


— Address translation 

— Addressing 

— Data 

— Decimal overflow 

— Decimal zero divide 

— Effective address overflow 
— Specification 


Note: The length of the quotient field is L, minus L, 
bytes. When the divisor length is larger than 7 (15 digits 
and sign) or larger than or equal to the dividend length, 
a specification exception occurs. 


DP Example 


Op |L,/L, D, 
F4 | 3] 2 3BO 
8 12 


0 Bits 16 20 32 36 47 


Assembler: DP D,(L,, B,), D2(L2, B2) 
Machine: F432 43B0 43D0 


B, (4) and B2(4): OOOA 1234 5000 


Storage — Before 


0/8 2/A 4/C 
OO0A 1234 53B0 0000 256F 
OOOA 1234 53D0 0003 OF 





Storage — After 


0/8 2/A 4/C 
OO0A 1234 53B0 8FOO O16F 
OOOA 1234 53D0 0003 OF 
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DIVIDE PACKED LONG (DPL) 
Instruction Description 


The dividend (first operand) is divided by the divisor 
(second operand) and replaced by the quotient and 
remainder. 


Format: SS 


uiutel o, |e), 
8 12 


O Bits 16 20 32 36 47 


Note: The Divide Packed Long instruction is 
implemented in vertical microcode (VMC) and is treated 
as an implicit SVL by the IMP processor. The op code 
is used as the index into the SVL table, as described in 
the section on SVLs in Chapter 6. 


Operation: L, specifies 1 less than the length in bytes of 
the divisor. The divisor can contain a maximum of 31 
digits and sign. 


The quotient is placed leftmost in the first-operand 
field, and can contain a maximum of 31 digits and sign, 
corresponding to a maximum of 15 for L,. The 
remainder is placed rightmost in the first-operand field 
and can contain a maximum of 31 digits and sign, 
corresponding to a maximum of 15 for L,. Together, the 
quotient and remainder occupy the entire first-operand 
field. 


When division by zero is attempted, a decimal zero 
divide exception occurs, and the operation is 
suppressed. 


Digit codes are checked for validity; invalid codes cause 
a data exception, and the operation is terminated. 


The dividend, divisor, and remainder are all signed 


integers, right-aligned in their fields. The quotient is a 
signed integer, but is left-aligned in its field. 
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Overflow: Not applicable. ) 
| 


Sign Code: The sign of the quotient is determined by 
the rules of algebra from the dividend and divisor signs. 
The remainder has the same sign as the dividend except 
that a zero quotient or a zero remainder is always 
positive. The processor uses the preferred signs for the 
quotient and remainder as follows: a positive sign is 
encoded as 1111 (hex F); a negative sign is encoded as 
1101 (hex D). 


The sign codes are checked for validity: invalid signs 
cause a data exception, and the operation is terminated. 


Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The divisor and dividend fields 
may overlap only if their rightmost bytes coincide; 
improperly overlapping fields cause a data exception, 
and the operation is terminated. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Decimal zero divide 
Effective address overflow 


Note: L, specifies 1 less than the length in bytes of the 
dividend plus the length by which the first-operand 
storage area exceeds the length of the divisor. The 
dividend is taken from the first L,+1 bytes of the first 
operand. The dividend can contain a maximum of 31 
digits and sign, corresponding to a maximum of 15 for 
L,. The rightmost L, bytes of the first operand are 
ignored unless they contain the divisor (due to 
overlapping operands). The maximum length of the first 
operand (L,+L,+2) is 32 bytes. 


DPL Example 





O Bits 12 16 20 32 36 


Assembler: DPL D,(L,, Bi), D2(L2, Bz) 
Machine: FA40Q 3F30 3FBO 
B, (3) and Bz(3): OOFA 12AB C000 


Storage — Before 
0/8 2/A 


OOFA 12AB CF30 2793 4766 
OOFA 12AB CFBO 3D 





Storage — After 
0/8 2/A 


OOFA 12AB CF30 0931 1588 
OOFA 12AB CFBO 3D 
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DIVIDE SHORT FLOAT (DSF) 


Instruction Description 


The first operand is divided by the second operand 
(two-operand format) or the second operand is divided 
by the third operand (three-operand format), and the 
quotient is placed in the first operand location. No 
remainder is saved. 


Format: SS 


feie| oo [el oo 
8 12 


0 Bits 16 20 32 36 47 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used if base 
register O is specified for the third operand. The 
three-operand format is used if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


Floating-point division uses exponent subtraction and 
significand division. The difference between the signed 
(unbiased) exponents of the dividend and the divisor 
operands is used as the signed exponent of the 
intermediate quotient when both the dividend and the 
divisor are normalized. 


When the dividend is denormalized and the divisor is 
normalized and nonzero, the difference between the 
signed exponents of the dividend and divisor operands 
less 1 is used as the signed exponent of the 
intermediate quotient. 


All dividend and divisor significand digits participate in 
forming the significand of the quotient. The intermediate 
quotient is calculated as if to infinite precision. 


Normalizing the intermediate quotient is never 
necessary, but a right shift of one digit position can be 
called for, which causes the intermediate quotient 
Significand to be shifted right one digit position. 


The intermediate quotient is rounded, if necessary, 
according to the rounding mode specified in the task 


dispatching element. 


When the dividend is O and the divisor is a finite 
number or infinity, the quotient is O. 


10-180 


If the divisor is denormalized and the dividend is 
normalized and not normal O, an invalid operand 
exception is recognized. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
quotient. The source operands are checked for this 
value in order of their specification with the masked 
not-a-number with the larger fraction value being 
provided as the quotient. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the quotient is determined by 
the rules of algebra. This amounts to the exclusive OR 
of the divisor and dividend signs and applies to 
quotients of 0 or infinity value as well as for normal 
finite results. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: All operands must be fullword 
aligned; otherwise, a specification exception occurs, and 
the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Floating-point zero divide 

— Specification 


J 


=e 
oo 
38 
2 
c 3 
a3 
pa | 
oO 0 
. 2 
5 Q 
3. 0 
Os 
QO 
oo 
3 
= Oo 
> 2 
—=— 
ra) 
5 © 
oO DH 
o 
of 
GCF 
® 3 
23 
ra 
S 2 
oo 
= 


Quotient First Source (Divisor) Second Source (Dividend) 
waar opeiendiexesptni 


Divide by zero exception +Real number # O or -real +0 or -0 
number # O 


+Real number # 0 


0 Real number # 0 


+0 (see note 
+0 (see note 
-0 (see note 
Invalid operand exception 
+Infnity 


+|nfinity +|nfinity 


+0 


o>) 


-Real number # O 











Oo 


-Infinity +Infinity -Real number # O 


“Infinity feinfinty 
of tninty 
of tnfinty 


+ |+ |+ |+ 
oO |o |o Jo 


Note: For a small value real number that does not equal O and a large value real number 
that does not equal 0, a masked floating-point underflow which yields a O rather than a 


denormalized result can occur. 
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First Source (Divisor) Second Source (Dividend) 
-¢__ miei 6 ____ Sania ont 


40 enfin 
Masked not-a-number Masked not-a-number Not not-a-number 
Masked not-a-number Not not-a-number Masked not-a-number 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operand exception Unmasked not-a-number 
Invalid operand exception aman eee Unmasked not-a-number 


Legend: 










Any = Any floating-point value. 






DSF Example 


Op D, 
AE O60 


0 Bits 16 20 32 36 47 


Assembler: DSF D, (B,), D2(B,), B3 Storage — Before 


Machine: AE34 4050 4060 


0/8 2/A 


0010 0200 0050 XXXX XXXX 
B3(3): 0010 0200 0070 0010 0200 0060 4100 0000 
0010 0200 0070 BF80 0000 


B, (4) and B,(4): 0010 0200 0000 





Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 


Condition Code: Not changed. 
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DIVIDE WORD STORAGE (DWS) 
Instruction Description 
The dividend (first operand) is divided by the divisor 


(second operand) and replaced by the quotient and 
remainder. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The dividend is a 64-bit, binary value 
occupying 8 bytes of storage at the first-operand 
location. It is replaced by a 32-bit signed remainder and 
a 32-bit signed quotient occupying the first and second 
words, respectively. The divisor is a 32-bit signed 
integer. 


When the relative magnitude of the dividend and divisor 
is such that the quotient cannot be expressed by a 
32-bit signed integer, a binary divide exception occurs, 
and the operation is suppressed. This includes attempts 
to divide by zero. 


Overflow: Not applicable. 


Sign Code: The sign of the quotient is determined by 
the rules of algebra. The remainder has the same sign 
as the dividend, except that a zero quotient or a zero 
remainder is always positive. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Both operands must start on a 
word boundary; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Binary divide 

Effective address overflow 
Specification 


DWS Example 
D, 
F40 

0 Bits 12 16 20 32 36 47 


Assembler: DWS D, (B,), D2 (Bz) 
Machine: EDOO 3EFO 3F40 


B,(3) and B2(3): 1C4F 3AB9 4000 


Storage — Before 


4/C 6/E 
1C4F 3AB9 4EFO 0000 A34F 
(41807) 


1C4F 3AB9 4F40 





Storage — After 


2/A A/C 6/E 


1C4F 3AB9 4EFO 0007 #FFFF' F768 
(+7) (-2200) 
1C4F 3AB9 4F40 FFED 


(-19) 
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EDIT PACKED DECIMAL (EDPD) 


Instruction Description 


The format of the source field (the second operand) is 
changed from packed to zoned decimal format, and is 
modified under control of the edit-mask field (the third 
operand). 


Format: RS 
pe | lel bp 
O Bits 8 16 20 31 


Operation: The edited result is placed in the result field 
(the first operand). The address of the first significant 
result character is placed in base register hex F. 


The first and second-operand addresses and their 
associated length codes are obtained implicitly from 
registers. Base register 14 points to the leftmost byte of 
the result field, and base register 15 points to the 
leftmost byte of the source field. Byte register 10 (r10) 
specifies one less than the number of bytes in the result 
field. Byte register 11 (r11) specifies the number of 
decimal digits exclusive of sign in the source field. The 
third-operand address (B,, D,) points to the leftmost 
byte of the edit-mask field. The length field (L,) 
specifies one less than the number of bytes in the 
edit-mask field. 


The maximum length of the source field is 31 decimal 
digits. If the source field length is zero, the sign is the 
only source data processed. The maximum length of the 
edit-mask field is 256 bytes, while the maximum valid 
length of the result field is 254 bytes. 


The source field is in packed decimal format. The edit 
mask contains control characters and data character 
strings. Both the edit mask and the source fields are 
processed left to right. The edited result from this 
processing is placed in the result field left to right. 


If the length of the source field is even, the high-order 
4 bits of the source field are ignored and not checked 
for validity, all other source digits and signs are checked 
for validity and a data exception is indicated when 
invalid. Any overlapping of these fields will yield 
unpredictable results. After validity checking, the sign of 
a source field with a value of zero (or digit length of 
zero) is considered to be plus (1111). 
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There are 10 types of control characters which may be 
found in the edit mask: hex AA through hex B3. In J 
addition to these control characters, if the first character 
of the edit-mask field is less than hex 40, the value of 
that character is used instead of hex AE as an 
end-of-string delimiter. This allows the use of 
characters with a value of hex AE within a string. Two 
of these control characters indicate the beginning of a 
type of field, two control characters indicate the 
beginning of a type of character string, and one is used 
to indicate the end of the character string. The other 
five control characters indicate that a digit from the 
source field should be checked and that appropriate 
action be taken. 


There is a significance indicator used in the execution of 
this instruction. At the start of the execution of this 
instruction, this indicator is set to the off state. It 
remains in this state until a nonzero source digit is 
encountered in the source field, or until one of the four 
unconditional digits (hex AA through hex AD) or an 
unconditional string (hex B3) is encountered in the edit 
mask. 


When significance is detected, the selected floating 
string specified by hex B1 is overlaid into the result field 
immediately to the left of the first significant result 


character. J 


When the significance indicator is set to the on state, 
the first significant result character has been reached. 
The state of the significance indicator determines 
whether the fill character or a digit from the source field 
is to be inserted into the result field for conditional 
digits and characters in conditional strings specified in 
the edit-mask field. The fill character will be a hex 40 
until it is replaced by the first character following the 
floating string control character, hex B1. 


YS 


When the indicator is in the off state: 


« A conditional digit control character in the edit mask 
causes the fill character to be moved to the result 
field. 


A character in a conditional string in the edit mask 
causes the fill character to be moved to the result 
field. 


When the indicator is in the on state: 


« A conditional digit control character in the edit mask 
causes a source digit to be moved to the result field. 


¢ A character in a conditional string in the edit mask is 
moved to the result field. 


The control characters found in the edit-mask field are: 


End-of-string character (EOSC) 


This control character indicates the end of a string of 
characters and must be present, even if the string is 
null. The value of this character is either that of the 
first character of the edit-mask field, if that character 
is less than hex 40, or it is hex AE. 


Start-of-static-field control character 


Hex AF: This control character indicates the start 
of a static field. A static field is used to indicate 
that one of two mask character strings 
immediately following this character is to be 
inserted into the result field, depending upon the 
algebraic sign of the source field. The string to be 
inserted into the result field, if the sign in the 
source field is positive, is the first string in the 
field. The second string in this field is the string to 
be inserted into the result field if the sign in the 
source field is negative. 


Static field format: 


Hex AF... positive string... EOSC... 
negative string . . . EOSC (end-of-string control 
character) 


« Start-of-floating-string control character 


Hex B1: This control character indicates the start 
of a floating string field. The first character of the 
field is used as the fill character. 


Following the fill character are two optional 
strings, delimited by the EOSC. lf the sign in the 
source field is positive, the first string in the field 
is to be inserted into the result field. The second 
string is to be inserted into the result field if the 
sign in the source field is negative. 


The string selected for insertion into the result 
field appears immediately to the left of the first 
significant result character, and is called a floating 
string. If significance is never set, neither string is 
placed in the result field. Conditional source digit 
positions (hex B2 control characters) must be 
provided in the edit mask immediately following 
the hex B1 field to accommodate the larger of the 
two floating strings, or a length conformance 
exception will be presented. For each of these hex 
B2 control characters, the fill character is inserted 
into the result field and source digits are not 
consumed. 


Floating-string field format: 


Hex B11 fill character . . . positive string... 
EOSC negative string .. . EOSC, hex B2... 


e Start-of-conditional-string control character 


Hex BO: This control character indicates the start 
of a conditional string. The string contains any 
character and is delimited by EOSC (the 
end-of-string control character). This string, or fill 
characters replacing it, is inserted into the result 
field based on the state of the significance 
indicator. When the significance indicator is in the 
off state, a fill character for every character in the 
conditional string is placed in the result field. 
When the significance indicator is in the on state, 
the characters in the conditional string are placed 
in the result field. 


Conditional string format: 


Hex BO... conditional string .. . EOSC 
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¢ String-of-unconditional-string control character: 


— Hex B3: This control character turns on the 
significance indicator and indicates the start of an 
unconditional string. This string consists of any 
character and is delimited by the EOSC 
(end-of-string control character). This string is 
unconditionally inserted into the result field 
regardless of the state of the significance 
indicator. 


If the significance indicator is off when a hex B3 
control character is encountered, the appropriate 
floating string is inserted (overlaid) into the result 
field prior to (to the left of) the hex B3 
unconditional string. 


— Unconditional string format: 
Hex B3 .. . unconditional string . . . EOSC 


Control characters that correspond to digits in the 
source fieid 


— Hex B2: This control character specifies that the 
corresponding source field digit or floating string 
(hex B1) field digit is considered a conditional 
digit. This means that either the source digit or 
the fill character is placed in the result field based 
on the state of the significance indicator. When 
the significance indicator is in the off state, the fill 
character is placed in the result field. When the 
significance indicator is in the on state, the source 
digit is placed in the result field. When a source 
digit is moved to the result field, the hex F zone 
receives the source digit. When significance (that 
iS, a nonzero source digit) is detected, the floating 
String is placed to the left of significance. 


Control characters hex AA, hex AB, hex AC, and 
hex AD will independently turn on the significance 
indicator. If the significance indicator is turned off 
when one of these control characters is 
encountered, the appropriate floating string is 
inserted (overlaid) into the result field prior to (to 
the left of) the source digit. 
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— Hex AA: This control character specifies that the 


corresponding source field digit is unconditionally J 
placed in the result field. The zone portion is set 

to a hex F. The source digit is placed in the four 

low-order result bits. 


Hex AB: This control character specifies that the 
corresponding source field digit is unconditionally 
placed in the result field. The zone portion of the 
digit is set to the preferred positive sign bits 1111 
(hex F) if the sign of the source field is positive, or 
to the negative sign bits 1101 (hex D) if the sign 
of the source field is negative. 


Hex AC: This control character specifies that the 
corresponding source field is unconditionally 
placed in the result field. The zone portion of the 
digit is set to the preferred positive sign bits 1111 
(hex F) only if the sign of the source field is 
positive. If it is not positive, the source sign field 
is moved to the result zone field. 


Hex AD: This control character specifies that the 

corresponding source field digit is unconditionally 

placed in the result field. The zone portion of the 

digit is set to the preferred negative sign 1101 

(hex D) only if the sign of the source field is 

negative. If it is not negative, the source field sign J 
will be moved to the zone position of the result 

byte. 


The Table of Valid Edit Conditions and Results provides 
an overview of the result obtained with the valid edit 
conditions and sequences. 


'NI: Not important 
2NC: No change 


Significance 


Indicator 


Before/After 


Nit /NC2 
NI/NC 


Source Sign 


Positive 
Negative 


Positive 


Negative 


NI 


Positive 


Negative 


Positive 
Negative 


Positive 


Negative 


Positive 
Negative 


Positive 


Negative 


Positive 


Negative 


Result Character 


Positive string inserted 

Negative string inserted 

Positive floating string overlaid; hex F, source 
digit 

Negative floating string overlaid; hex F, 
source digit 

Hex F, source digit 

Positive floating string overlaid; hex F, source 
digit 

Negative floating string overlaid; hex D, 
source digit 

Hex F, source digit 

Hex D, source digit 

Positive floating string overlaid; hex F, source 
digit 

Negative floating string overlaid; sign, source 
digit 


Hex F, source digit 


Sign, source digit 


Positive floating string overlaid; sign, source 
digit 

Negative floating string overlaid; hex D, 
source digit 

Sign, source digit 

Hex D, source digit 


Insert fill character for each hex BO string 
character 


Insert hex BO character string 





Instruction Descriptions 10-187 





Significance 
Mask Character | Indicator Source 
(Hex) Before/After | Digit Source Sign Result Character 


B1 (including Insert the fill character for each hex B2 that 
necessary B2s) corresponds to a character in the longer of 
the two floating strings 


B2 (not for a B1 NI Insert fill character 
field) 


Positive Overlay positive floating string and insert hex 
F, source digit 


Negative Overlay negative floating string and insert hex 
F, source digit 


NI Hex F, source digit 


Positive Overlay positive floating string and insert hex 
B3 character string 


Negative Overlay negative floating string and insert hex 
B3 character string 


NI Insert hex B3 string 


‘INI: Not important 
2NC: No change 





Overflow: Not applicable. Program Exceptions: 


— Address translation 


Sign Code: See Operation. — Addressing 

— Data 

— Edit digit count 
Condition Code: Not changed. — Edit mask syntax 


— Effective address overflow 
— Length conformance 
Carry: Not applicable. — Specification 


Boundary Requirements: Unpredictable results will occur 
if the first, second, or third operands are overlapped. 
The source field length must not exceed 31 decimal 
digits; otherwise a specification exception is recognized 
and the operation is suppressed. 
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Programming Notes: 


1. 


A source length equal to zero implies that only the 
sign is processed (examined). 


. Base registers 14 and 15 and byte registers 10 and 


11 are not altered by this instruction. 


. The result field may be partially modified if EDPD is 


interrupted before processing has completed. In this 
case, the EDPD operation will be restarted upon 
completion of interrupt processing. 


. Any character is a valid fill character, including hex 


AE. 


. Hex AF, hex B1, hex BO, and hex B3 strings must be 


terminated by the EOSC, even if they are null strings. 


. If a floating string (hex B1) field has not been 


encountered (specified) when the significance 
indicator is turned on, the floating string is considered 
to be a null string and is therefore not used to 
overlay into the result field. 


The following is a truth table which indicates the valid 
ordering of control characters in an edit-mask field. 


Control Character Y 


Hex AA, AB, AC, AD 





Control 
Character 
Xx 





Condition Definition 


0 Both X and Y can appear in the 
edit-mask field in either order. 


1 Y cannot precede X. 
2 X cannot precede Y. 
3 Both contro! characters (two hex B1s) 


cannot appear in the edit mask field. 


Note: Violation of the above rules will result in an 
edit-mask syntax program exception. 
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EDPD Example , 
> 

Op L, D, 
63 20 342 

QO Bits 8 16 20 31 

Assembler: EDPD D3(L3,B3) 

Machine: 6320 4342 

B3(4): 011A 3247 0000 (Base register for mask) 


B(14): O2BC 4431 0680 (Address of result) 


B(15): O2BC 86AA BO12 (Address of source) 


r(10): 10 (Length of result-1) 
r(11): OB (Number of digits in source field) 
L3: 21 (Number of bytes in edit-mask field -1) 
Storage — Before Storage — After 


011A 3247 0342 
(Edit mask) 


011A 3247 0342 
(Edit mask) 


O2BC 4431 0680 
(Result field) 


O2BC 86AA B012 
(Source field) 


O2BC 4431 0680 
(Result field) 


O2BC 86AA B012 
(Source field) 





Result will print as: 6464%6$12,345.67DB 
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Character(s) 
Placed in Result 


Edit Mask Characters 
Source is Negative 





Significance 
Source Indicator 
Digit (Before/After) 


2 fo Reset reset 
2 Reset /reset 
2st reset 


Description 








B1405BAE5BAEB2 


Floating string format specifies hex 





40 fill character and floating $ (hex 
5B) 


Reset/set Conditional digit negative floating 
string overlays previous fill character 
(5B overlays 40) 








Reset/reset 





possac [Not Used |Set/Set_—_| 
2 Setset 
ez Setset 
2s | Setysot Conditional digit 

Not Used 48 

F6 

F7 










B34BAE Not Used 
aa Set/sot 


Unconditional digit 
Unconditional digit 


Unconditional string 
Static field-negative string to result 
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ENABLE TASK DISPATCHING (ETD) 
Instruction Description 


This instruction enables task dispatching by setting the 
task dispatcher mask (byte hex 22, bit 7 of LSR [local 
storage register ]) and invoking the task dispatcher. 


Format: RR 


O Bits 8 12 15 


Operation: Control may not be immediately returned to 
the next sequential instruction of the function issuing the 
Enable Task Dispatching instruction if a higher priority 
task TDE (task dispatching element) is on the TDQ (task 
dispatching queue). 


This instruction also restarts the task interval timer if no 
task switch occurs and the current task is timed. If a 
task switch occurs, the task dispatcher sets the task 
interval timer depending upon whether the new task is 
timed or untimed. 


Overflow and Sign Code: Not applicable. 
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Condition Code: Not changed. ) 
Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


Programming Note: The Enable Task Dispatching 
instruction does not check whether or not the task 
dispatcher mask is already set prior to the execution of 
this instruction. 


ETD Example 


Op 

OD 
O Bits 8 12 15 
Assembler: ETD 


Machine: ODOO 


The following bit is set by this instruction: LSR ) 
byte 22 (FLGO), bit 7 (flag task switch blocked). 


This page is intentionally left blank. 
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ENQUEUE MESSAGE (EQM) 
Instruction Description 


The SRM (send/receive message) addressed by B, is 
checked for validity and, if valid, is enqueued to the 
message list of the send/receive queue designated by 
the second operand. 


Format: RS 


ec [eliie| 
8 


0 Bits 12 16 20 31 


Operation: The enqueuing method is designated by the 
Il-field. The message list is searched, in sequence, 
beginning with the first message. The new message 
(the first operand) is enqueued before the first message 
that satisifies the search type. If the list is empty, the 
new message is enqueued first. If the search type is not 
satisified, the new message is enqueued last. Search 
keys begin in byte 8 of the SRM, have a length 
specified in the queue header, and are treated as 
unsigned binary data. 


I-Field Search Type 

Bit 12 Searched Message Key = The first 
operand Message Key 

Bit 13 Searched Message Key < The first 
operand Message Key 

Bit 14 Searched Message Key > The first 
operand Message Key 

Bit 15 Not used 


The search type is the logical OR of the I|-bits specified. 
Therefore, | = binary OOOx results in enqueue last and | 
= binary 111x in enqueue first. 
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Overflow and Sign Code: Not applicable. 
2 
Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRM descriptor 
— Descriptor access: Monitored SRQ descriptor 
— Effective address overflow 

— Invalid descriptor 

— Specification 


Note: The key length specification in the queue header 

is key length minus 1. Therefore, if enqueue first or 

enqueue last is specified, the key/text portion of the 

SRM must be at least 1 byte long. Also, no check is ’ 
made for a page crossing in the key field, if enqueue J 
first or enqueue last is specified. 


e 


EQM Example 


Op |B, D. 

6C 4 000 
O Bit 8 12 16 20 31 
Assembler: EQM B,, D2(B2), I3 
Machine: 6C48 5000 


B, (4): 21A0 1240 0000 


B2(5): 0020 32A0 0000 


21A0 1240 0000 


Next Message 
Address 
XXXX XXKXX XXXX 


Message 





Bytes 


Before 


0020 32A0 0000 





Bytes 





First TDE 
Address 
XXXX XXXKX XXKX 


Next Message 
Address 
XXXX XXXX XXXX 















First Message 





Address ieee 
0000 0200 1000 sili 
10 


Message 





Bytes 


After 


0020 32A0 0000 





Bytes 


21A0 1240 0000 






First TDE 
Address 
XXXX XXXX XXXX 


Next Message 
Address 
0000 0200 1000 












First Message 


Address ney ; 
21A0 1240 0000 ee 
10 


Message 





Bytes 


0000 0200 1000 


Next Message 
Address 
XMKXKX KXKKXX KXXXX 


Message 





Bytes 
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ENQUEUE TASK DISPATCHING ELEMENT (EQTDE) 
Instruction Description 


The TDE (task dispatching element) addressed by B, is 
checked for validity and, if valid, is enqueued to the 
TDQ (task dispatching queue), SRO (send/receive 
queue) wait list, or SRC (send/receive counter) wait list 
designated by the second operand. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: Enqueuing is in key sequence; low key first, 
last within key value. TDE bytes hex 16-1B, the address 
of the current queue, are set to the second-operand 
address. 


Overflow and Sign Code: Not applicable. 
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Condition Code: Not changed. ) 
Carry: Not applicable. 
Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRQ descriptor 

— Descriptor access: Monitored TDE descriptor (if 
the second operand is an SRQ) 

— Effective address overflow 

— Invalid descriptor 

— Specification 


EQTDE Example 

Op |B, B, D, 

6D 3 4 350 
0 Bit 8 12 16 20 31 
Assembler: EQTDE B,, D2 (B2) 
Machine: 6D30 4350 
B, (3): 13A2 1442 0550 
B2 (4): 21A3 A983 0000 


Next TDE Address 
XXXX XXXX XXX 


Priority 
0000 0123 


13A2 1442 0550 









































Bytes 2 8 
Before 
21A3 A983 0350 Descriptor First TDE Address 
0000 0300 4000 
Bytes 2 8 
Next TDE Address Priority 
D 
0000 0300 4000 XXXX XXXX XXXX 0000 0124 
Bytes 2 8 
After 
First TDE Address 
21A3 A983 0350 13A2 1442 0550 
Bytes 2 8 
Next TDE Address Priority 
13A2 1442 0550 0000 0300 4000 0000 0123 
Bytes 2 8 
Next TDE Address Priority 
D 
0000 0300 4000 XXXX XXKK XXXX 0000 0124 





Bytes 2 8 
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EXAMINE PRIMARY DIRECTORY ENTRY (EPDE) 


Instruction Description 


The primary directory entry pointed to by the first 
operand is examined to determine if the frame with 
which the entry is associated can be reused. The result 
is returned via condition code. 


Format: Sl 


0 Bit 8 12 16 20 31 


Operation: The primary directory entry is first checked 
for validity. The diagram on the next page outlines the 
operation of the EPDE instruction 


The primary directory entry is identified by the first 
operand, which occupies 2 bytes in storage. Bits 0-15 
of the first operand are used as the primary directory 
index value. These bits are shifted left 4 bits to convert 
them from an index to an offset. Bits 12-15 become 
zeros. 


The high-order 4 bits of the primary directory index 


identified by the first operand are not used. 


Overflow and Sign Code: Not applicable. 
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Condition Code: 


0 The page is not pinned, but it does not satisfy 
the criteria for reuse. 

1 The page is not pinned, and it satisfies the 
criteria for reuse. It has been removed. 

2 The page is pinned either by a user or storage 
management. 

3 The page satisfies the criteria for reuse, but the 
change bit is on. 


Carry: Not applicable. 


Boundary Requirements: The first operand must be 
halfword aligned; otherwise, a specification exception is 
recognized and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


re 


EPDE Example 


Op E |B, D, 
83 3] F 002 
31 


O Bits 8 12 16 20 


Assembler: EPDE D, (B,) 


Machine: 8303 F002 


Before and After 


B,(F): 0000 0102 DF90 


Primary Directory Address: 0000 0103 0000 


Hash Table Address: 0000 0102 O000 


0000 0102 DF92 


0000 0103 0820 


0000 0102 0004 


0000 0103 0820 


0000 0102 0004 


Condition Code: 


Storage — Before and After 
2/A 
0082 


PD Entry Index 





Storage — Before 


0/8 2/A 4/C 
0010 0200 0080 0084~<—Primary 























0040 0020 Directory 
82 Entr 

Hash Table cnn” 
Storage — After 

0/8 2/A 4/C 

0000 0101 0400 Primary 

0040 0020 Directory 

0084 Entry 





Hash Table Entry” 





Before After 
x 1 
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Operation Diagram: 
IF the PD entry is valid (bit 40=1), J 
THEN IF the page is not pinned (bits 64-71 and bits 75-79=0), 
THEN IF the page has not been referenced (bit 41=0), 
THEN IF the purge indicator (bit 73) is a 1, 
the usage code (bit 90) is a 1, 
THEN IF the page has been changed (bit 42=1), 
THEN the condition code is set to 3. 
ELSE the PD 1/O use bit (bit 44) is checked. If the page is being used by |/O (bit 44=1), the 
page is removed from the |/O resolved address registers. The PD entry virtual address is 
hashed and the chain is searched. If the entry is not found on this chain, a specification 
exception is recognized and the operation is terminated. If the entry is on the chain, the SID 
and PID entries (bit O-39) are updated as follows: Bits O-23 are forced to hex 00 0001; bits 
24-39 are updated by shifting the index of the PD entry left by 1, inserting a O in the vacated 
low-order bit position, and storing the result in bits 24-39. Bits 40-63 are forced to zeros. The 


entry is then removed from the PD chain and the condition code is set to 1. 


ELSE the purge bit is set ON (bit 73=1), the condition code is set to O, and the instruction is F 
terminated. 


ELSE the purge indicator (bit 73) and reference bit (bit 41) are set to binary O. 

IF the directory entry is for a V=R address, 
THEN a specification exception is recognized and the operation is terminated. 

ELSE if the lookaside buffer contains an entry for the page associated with the directory entry, the 
change bit in the loookaside buffer entry is ORed into the change bit (bit 42) of the PD entry, 
then removed from the lookaside buffer. The condition code is set to O. 


ELSE the condition code is set to 2. 


ELSE 
IF the page is not pinned (bits 75-79=0) by storage management. 


THEN IF the virtual address is V=R, 
THEN the condition code is set to 1. 
ELSE the condition code is set to O. 


ELSE the condition code is set to 2. 
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EXCLUSIVE OR BYTE (XB) 
Instruction Description 


The exclusive OR of the first and second operands is 
placed in the first-operand location. 


Format: RS 
(7 Inje|s] 
O Bits 12 16 20 31 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


II 
o>) 


Result 
Result + 0 


WON — © 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 


— Addressing 


— Effective address overflow 


XB Example 


: 
ao 


O Bits 12 


Assembler: XBr,, D,(B.) 


16 20 


Machine: 7972 3310 


B,(3): 1131 1132 2000 


1131 1132 2310 


r,(7): 


Condition Code: 


Storage — Before and After 





Before 


AF 


Xx 


After 


55 
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EXCLUSIVE OR BYTE IMMEDIATE (XBI) 
Instruction Description 


The exclusive OR of the first and second operands is 
placed in the first-operand location. 


Format: S| 
Poa] [af oo 
QO Bits 8 16 20 31 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR Is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


I 
oO 


Result 
Result # 0 


WN = Oo 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 
) 


— Address translation 
— Addressing 
— Effective address overflow 


XBI Example 
Op l, B, D, 
9A 32 3 980 
O Bits 8 16 20 31 


Assembler: XBI D, (B, ), I, 
Machine: 9A32 3980 


B,(3): 0000 4250 AOO0 


Storage — Before 


0000 4250 A980 





Storage — After 


0000 4250 A980 





Before After 


Condition Code: x 1 


EXCLUSIVE OR BYTE REGISTER (XBR) Carry: Not applicable. 


Instruction Description 

Boundary Requirements and Program Exceptions: None. 
The exclusive OR of the first and second operands is 
placed in the first-operand register. 

XBR Example 


Format: RR Op r, 
1A 7 


O Bits 8 12 15 
Assembler: XBR r,,fr2 
Operation: Operands are treated as logical quantities, 


and the connective exclusive OR is applied bit by bit. A Machine: 1A67 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the Before After 
result bit is reset. 
r, (6): 2D 12 
Overflow and Sign Code: Not applicable. r2(7): 3F 3F 
Condition Code: x 1 


Condition Code: 


Result = 0 
Result + 0 


WON - © 
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EXCLUSIVE OR BYTE REGISTER IMMEDIATE 
(XBRI) 
Instruction Description 


The exclusive OR of the first and second operands is 
placed in the first-operand register. 


Format: RI 
jaa tefol 4. | 
O Bits 8 12 16 24 31 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result # 0 


WN -—- O 
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Carry: Not applicable. ) 


Boundary Requirements and Program Exceptions: None. 


XBRI Example 


Op r, IL 
4A 3 B9 
QO Bits 8 12 16 24 31 
Assembler: XBRIr,, I, 
Machine: 4A30 B900 
Before After 
r, (3): 42 FB 


Condition Code: x 1 


EXCLUSIVE OR CHARACTER (XC) 
Instruction Description 


The exclusive OR of the first and second operands is 
placed in the first-operand location. 


Format: SS 
O Bits = 20 32 36 47 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Each operand field is processed left to right. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result +# 0 


ON - Oo 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
leftmost byte of the first operand is coincident with or 
to the left of the leftmost byte of the second operand; 
otherwise the overlap is destructive and the results are 
unpredictable. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


XC Example 
Op D, 
CA a a 810 
O Bits 16 20 32 36 47 


Assembler: XC D,(L,B,), D2(B2) 
Machine: CA03 4800 4810 


B, (4) and B,(4): 1801 1802 1000 


Storage — Before 


0/8 2/A 
1801 1802 1800 C5C6 + C7C8 
1801 1802 1810 CiC2 C3c4 





Storage — After 


0/8 2/A 
1801 1802 1800 0404 O040C 
1801 1802 1810 C1iC2 C3Cc4 





Before After 


Condition Code: x 1 
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EXCLUSIVE OR HALFWORD (XH) 
Instruction Description 
The exclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RS 


| 20 |, 


O Bit 8 12 16 20 31 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result # 1 


WN - Oo 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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Program Exceptions: 


— Address translation 
Addressing 

Effective address overflow 
Specification 


XH Example 
Op |R,| E |B, D, 
80 8 | 5b 1.3 330 
O Bits 8 12 16 20 31 


Assembler: XH R,, D2 (Bz) 
Machine: 8085 3330 


B2(3): 0633 0634 0000 


Storage — Before and After 


0633 0634 0330 





Before After 
R, (8): 0632 0004 


Condition Code: x 1 





EXCLUSIVE OR HALFWORD REGISTER (XHR) 
Instruction Description 
The exclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RR 


| 2a ale, 


O Bits 8 12 15 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result + 0 


WON — © 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


XHR Example 
Op R, 
2A A 

O Bits 8 12 15 


Assembler: XHR R,, R2 


Machine: 2A9A 


Before After 
R,(9): BB76 44FE 
R2 (A): FF88 FF88 
Condition Code: x 1 
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EXCLUSIVE OR HALFWORD REGISTER IMMEDIATE 
(XHRI) 
Instruction Description 


The exclusive OR of the first and second operands is 
placed in the first-operand register. 


Format: Rl 
psa ltrio| 
O Bits 8 12 16 31 


Operation: Operands are treated as logical quantities, 
and the connective exclusive OR is applied bit by bit. A 
bit position in the result is set if the corresponding bit 
positions in the two operands are unlike; otherwise the 
result bit is reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 0 
Result +# 0 


ON — O 
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Carry: Not applicable. 
) 


Boundary Requirements and Program Exceptions: None. 


XHRI Example 


Op /|R, I. 

5A C FOFO 
O Bits 8 12 16 31 
Assembler: XHRI R,, l2 
Machine: 5ACO FOFO 
Before After 
A2A2 5252 


R,(C): 


Condition Code: x 1 


This page is intentionally left blank. 
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EXECUTE (EX) 
Instruction Description 
The single instruction at the second-operand address is 


modified by the contents of the byte register specified 
by r,, and the resulting instruction is executed. 


Format: RS 
|e |nlole| ov, 
O Bits 8 12 16 20 31 


Operation: Bits 8-15 of the instruction at the 
second-operand address are ORed with the bits of the 
register specified by r,, except when register zero is 
specified, which indicates that no modification takes 
place. The ORing does not change either the contents 
of the register or the instruction in storage, and it is 
effective only for the interpretation of the instruction to 
be executed. 


The execution and exception handling of the subject 
instruction are exactly as if the subject instruction were 
obtained in normal sequential operation, except for the 
instruction address and the instruction length code. The 
instruction address is increased by the length of the 
Execute instruction in order to form the updated 
instruction address. 


When the subject instruction is another Execute 
instruction, an execute exception occurs and the 
operation is suppressed. The second-operand address 
must be even; otherwise a specification exception 
occurs. 
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Overflow and Sign Code: Not applicable. 
| 


Condition Code: The code may be set by the subject 
instruction. 


Carry: Not applicable. 


Boundary Requirements: The second operand must 
begin on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Execute 

Specification 


C 


EX Example 


Op B, 
7E A 


O Bits 8 12 


Assembler: EX r, 


16 20 


, D2 (Ba) 


Machine: 7E10 AOOO 


B2(A): 0000 3820 0000 


Before 


ry, (1): 99 


0000 3820 0000 


After 


99 


Storage — Before and After 


0/8 
9B66 


D, 
000 
31 


2/A 
CO03 


4/C 





Op LL B, D, 
9B 66 C 003 


O Bits 8 16 20 31 


Assembler: MVBI D,(B,), I. 
Machine: 9B66 C003 


B,(C): 0000 8916 0000 


Bits 8—15 66 
Bits r, (1) 99 
Result FF 


The MVBI instruction is executed as if it were: 


Op L, B, D, 
9B FF C 003 


O Bits 8 16 20 31 


If the EX instruction is located at 0000 3820 OOOO, 
the next instruction to be executed is at address 
0000 3820 0004. 
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EXTRACT TAGS (EXTAG) 
Instruction Description 


This instruction saves the tags when the page is written 
to auxiliary storage. The pointer tag bits associated with 
the block of storage addressed by the second operand 
are stored in the halfword addressed by the first 
operand. 


Format: SS 
. [e| o, [ef o 
0 Bits 8 16 20 32 36 47 


Operation: Tags are extracted from the second operand, 
one bit for each quadword, and placed in the first 
operand. The second operand remains unchanged after 
the operation. L, applies only to the number of bytes of 
the second operand minus 1. 


The first operand is a halfword in storage with each bit 
(starting with the leftmost bit) containing the tagged 
indication for each of the quadwords of the second 
operand. Any partial quadword at the end of the second 
operand would reset the corresponding bit of the first 
operand. Any unused bits of the first operand are reset. 
The quadword containing the first operand is untagged 
by this operation. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first operand must start on 
a halfword boundary and the second operand must start 
on a quadword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


EXTAG Example 


The example shows 2 EXTAG instructions being used to 
extract the tags from PAGE1 and put them in the two 
halfwords at FIELD1 and FIELD1+2. 





Q Bits 16 20 32 36 


Assembler: EXTAG D,(B,),D,(L,,B,) 


Machine: A4FF 4000 5000 





0 Bits 16 20 32 36 


Machine: A4FF 4002 5100 

B,(4): O20A B76C OOOO 

B,(5): O20A B62A QOOO (This is the address of PAGE1.) 
Assume that PAGE1 contains a tagged pointer in the 


quadwords at addresses 020A B62A 0030 and O20A 
B62A 0040 but no other pointers exist on the page. 


Storage — Before 


0/8 2/A 4/C 6/E 
020A B76C 0000 XXXX XXXX 
FIELD1 FIELD1+2 





Storage — After 


0/8 2/A 4/C 6/E 
020A B76C 0000 1800 0000 


FIELD1 FIELD1+2 
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FREE HOLD RECORD (FHR) 
Instruction Description 


This instruction is designed to be a continuation of a 
Free Hold Record First instruction that was interrupted. 
Therefore, the execution is almost identical except for 
some initial conditions. The FHR instruction assumes 
that the hold record chain has been marked busy by a 
previous Free Hold Record First instruction, and instead 
of using an object address and hash table to locate the 
first hold record to check, the FHR instruction assumes 
the address of a hold record is loaded in a register. 


The FHR instruction also checks for pending 
interruptions during execution. When the FHR 
instruction terminates, it is necessary to check the 
condition code to determine if the instruction was 
interrupted. 


Format: RS 


_s7 [eles] o, 
8 


0 Bits 12 16 20 31 


Operation: The first-operand hold records are checked 
to see if the second-operand free request can be 
granted. The outcome of this check is as follows: to 
grant the free request, to signal an error condition, or to 
indicate that further hold records on the chain must be 
checked. In the first and last cases, the first-operand 
base register is loaded with the address of the 
appropriate hold record. 


A 4096-byte HHT (hold hash table) is accessed. Its 
address is given in bytes hex 8A-8F of the CAT. This 
HHT address is set by IMPL to point to the first byte in 
the page. 
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This instruction functions the same as the Free Hold 
Record First instruction except for the following J 
differences. The address of the last hold record 
previously checked (by a prior execution of a FHRF or a 
FHR instruction) is found in the first-operand base 
register. Instead of hashing the third object address and 
going through HHT, the address of the first hold record 
address is calculated by multiplying bytes hex A and B 
of the present hold record by 16 and then concatenating 
the 20 bit result with the 28 high order bits of the 
available hold record entry in bytes 92 through 97 of the 
control address table. This hold record is not the first 
on the chain, so an end of chain exception is not 
invoked by an empty chain. Also, its busy flag is not 
checked; thus, a descriptor access busy exception 
cannot occur in this instruction. 


Because this instruction checks groups of hold records 
starting within the object hold chain, it does not set the 
chain busy flag in the first hold record of the chain 
when the condition code 3 exit is used (the flag is 
assumed to have been set by the execution of a 
preceding Free Hold Record First instruction). However, 
when the condition code O exit is used, it must go back 
to the first hold record in the chain and reset the 
record's busy flat (bit 5 of the first byte). 


Finally, when condition code 3 is set, the address loaded J 
into the first-operand base register points to the alst 

hold record checked. This is similar to the Free Hold 

Record First or Grand Hold Record instruction, which 

loads the address of the next hold record to be checked. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result free was allowed. 
1 = 
2 eS 
3 Continue searching hold chain. 





Carry: Not applicable. FHR Example 


See the Free Hold Record First instruction example. 
Boundary Requirements: The second-operand hold 
request block must be halfword aligned and the / 57 |p\/clp| oo | 
first-operand hold record must be quadword aligned. If 0 Bits 8 12 16 20 31 
either requirement is violated, a specification exception 
occurs and the operation is suppressed. Assembler: FHR B,,B,,D.(B,) 


Machine: 57BC DOO6 
Program Exceptions: 


— Address translation 

— Addressing 

— Chain conflict 

— Effective address overflow 
— End of chain 

— Second chain search 

— Specification 


Programming Note: |f a program exception occurs, the 
busy flag is not reset. 


Instruction Descriptions 10-215 


FREE HOLD RECORD FIRST (FHRF) 


Instruction Description 


The FHREF instruction removes entries from a list of hold 
records, which contain a 6-byte object address, a hold 
byte, and the identification of the TDE (task dispatching 
element) that requested the hold on the object. The list 
of hold records is searched until a record matching the 
input data is found. Then, if the maching entry is not 
monitored, it is removed. If no match can be found, an 
end-of-chain exception occurs. 


The starting point for the search of the hold records is 
found by hashing the 6-byte object address. An entry in 
a hash table points to the first hold record to be 
checked. Then each hold record contains the address of 
the next hold record to be checked. As each hold 
record is checked, its 6-byte address is placed in a 
register. The last entry on a chain is indicated by a flag 
bit in the hold record. When a hold record is removed 
from the chain, it is placed on the chain of available 
hold records. The address of the hash table and the 
start of the chain are located in the control address 
table. While this instruction is executing, it periodically 
checks for pending interruptions. 


Format: RS 
(47 lelete| 
0 Bits 16 20 31 


Operation: The first hold records in the hold record 
chain of the third-operand object are checked for one of 
the following purposes: to free a hold record, to signal 
that no matching record can be found to be freed, or to 
indicate that further hold records on the chain must be 
checked. In the first case, the first-operand base 
register is loaded with the address of the freed hold 
record. In the third case, the first-operand base register 
is loaded with the address of the last checked hold 
record in the chain. 


10-216 


A 4096-byte HHT (hold hash table) is accessed. Its 
address is given in bytes hex 8A-8F of the control 
address table. This HHT address is set by IMPL to point 
to the first byte in the page. 


The third-operand register contains an object address. 
This 6-byte effective address is hashed to create a 
2-byte index into a hold hash table. The 2-byte hash 
table entry selected (when multiplied by 16 and 
concatenated to the right of the 28 high-order segment 
bits of the available hold record address) addresses the 
first hold record in the chain for the third-operand 
object address and its hash synonyms. If the chain is 
empty (contains no hold records), the hold hash table 
entry is all zeros. In this case, the free requested by the 
second-operand cannot be granted. An end-of-chain 
program exception is recognized, the first-operand 
register contents are unchanged, and the operation is 
nullified. 


If the hold hash table entry is not all zeros, the 
addressed hold record is accessed. The 2-byte hold 
hash table entry is multiplied by 16 and concatenated to 
the right of the high-order 28 bits of the AHR (available 
hold record) address. This new value points to the first 
hold record on the chain (the start of the hold record 
area). The chain busy flag (bit 5 of the first byte) of the 
hold record is checked. If the chain busy flag is set, the 
first-operand register is unchanged, a descriptor access 
busy exception occurs and the operation is nullified. If 
the chain busy flag is not set, hold records are checked 
for a matching record; the figure below indicates the 
number of records to be checked. A matching record or 
end-of-chain flag set in any hold record prohibits 
checking additional hold records. If no matching records 
are found in the first or previous check, a check is made 
for pending external interrupts. If none are pending, 
additional groups of records are checked. If an interrupt 
is pending, it is handled the same as in a page fault. 
The instruction finishes as follows. 


a Checked 
Models ‘initial —_| Additional 
a 13 


6, 7, and 8 





J 


The condition code is set to 3, the first-operand register 
is loaded with the address of the last hold record 
checked (note this difference from operation of the 
Grant Hold Record First instruction), the chain is busy 
flag (bit 5 of the first byte) in the first hold record for 
this object chain is set, and the operation is completed. 


For a matching hold record to be found, three fields in 
the hold record are checked. The 6-byte object address 
field (bytes 2-7) must match the third-operand register 
contents; the 1-byte hold field (byte 1) must match the 
second-operand hold field (byte 1); and the 2-byte TDE 
identifier field (bytes 8-9) must match the TDE identifier 
located in bytes hex 94-95 of the current TDE. If all 
three match, this hold record can be removed from the 
object hold chain and returned to the available hold 
record chain. See Freeing a Hold Record, later in this 
instruction description. 


Primary Chain Search 


If the object address does not match, the EOC 
(end-of-chain) flag (byte O, bit 6) is checked. If the 
EOC flag is set, no matching hold record can be found. 
The first operand base register is unchanged, an EOC 
exception occurs, and the operation is nullified. If the 
EOC flag is reset, the processor checks for pending 
external interrupts. If there are no pending interrupts, 
searching continues with the next hold record on the 
primary chain (pointed to by the index in bytes 10 and 
11 of the current hold record). 


If an object address matches, the other two checks are 
made (on the hold record and the TDE identifier). If 
either of these does not match, the head of the 
secondary chain bit (byte O, bit 0) is checked. If this bit 
is reset, no secondary chain exists and no other holds 
could have been placed on this object. The first operand 
base register is unchanged, an EOC exception occurs, 
and the operation is nullified. If the head of secondary 
chain bit is set, the secondary chain must be searched. 


Secondary Chain Search 


The secondary chain is searched in the same manner as 
the primary chain. If a compare is not found, the 
end-of-secondary chain flag bit (hold record bytes C 
and D) is checked. If this is the last hold record on the 
secondary chain, no matching hold record can be found. 
The first operand base register is not changed, an EOC 
exception occurs, and the operation is nullified. If the 
current hold record is not the EOC, a check is made for 
pending external interrupts. If none are pending, the 
secondary chain search continues with the next hold 
record pointed to by bytes C and D. 


Freeing a Hold Record 


If the monitor flag is set, the first operand base register 
is loaded with the address of the monitored hold record, 
the chain busy flag is set, a chain conflict exception 
occurs, and the operation is nullified. See Programming 
Note. If the monitor flag is reset, the matching hold 
record is freed, the condition code is set to O, and the 
operation is completed. 


Programming Note: Two other values are passed in the 
TDE. If the monitored hold record is at the top of chain, 
the TDE contains the hash table entry offset for this 
chain. If the monitored hold record is not at the top of 
the chain, the TDE contains the index of the hold record 
just prior to the monitored hold record. 


To be freed, a matching hold record must be removed 
from the object hold chain and returned to the available 
hold record chain with some of its fields initialized and 
both chains updated to reflect the changes. The flag 
byte, the TDE identifier field, and the second chain 
pointer and cumulative hold field of the freed record are 
reset. The address of the AHR (available hold record) 
chain from the control address table is converted to a 
hold record index and the resultant 2-byte value is 
loaded into the object chain field of the freed record. 
The address of the freed record is loaded into the 
control address table AHR chain entry. The value in the 
current TDE’s hold count field is decreased by 1. 
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Freeing from the Secondary Chain 


If this is the last hold record on the secondary chain, 
which is indicated by secondary chain flag, the previous 
hold record has its secondary chain field set to zero. If 
this hold record is the head of the secondary chain, the 
head of the secondary chain flag is reset, and the 
cumulative hold fields are updated. See Cumulative Hold 
Updates later in this instruction description. 


If the hold record to be freed is not last on the 
secondary chain, it is removed from the chain by moving 
its backward pointer to the backward pointer field of the 
next record. Then the secondary chain field is moved to 
the secondary chain field of the previous hold record 
and the cumulative hold fields are updated. 


Freeing from the Primary Chain 


If the freed hold record is the head of the secondary 
chain, the head of the secondary flag is reset. The 
second hold record on the secondary chain becomes the 
head of the seconday chain. The secondary chain index 
of the freed hold record is moved to the hold record 
chain index of the previous hold record on the primary 
chain, or into the appropriate hash hold table entry if the 
freed record was the first on the object chain. The new 
head of secondary chain hold record has its 
head-of-secondary chain flag set, unless it is the end of 
the secondary chain. The end-of-primary chain flag on 
the freed hold record is checked, and if it is set, the 
hold record that has just been marked the 
end-of-secondary chain is also marked the 
end-of-primary chain. If the EOC flag is reset, the hold 
record chain index of the freed hold record are moved 
to the new head of secondary chain. 


If the freed hold record is not the head of secondary 
chain and the end-of-primary chain flag is set, the EOC 
flag is set in the preceding hold record in its chain. If it 
was first on the chain, the object chain's HHT (hold 
hash table) entry is set to zero. If there is no secondary 
chain and the freed hold record was not at the end of 
the primary chain, the object chain field of the record is 
moved into the object chain field of the preceding hold 
record on the object chain or into the appropriate hash 
table entry if the freed record was the first on the object 
chain. 
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Cumulative Hold Updates ) 


The cumulative hold field is an OR (noninclusive) of the 
remaining holds on the secondary chain. When a hold 
record is removed from the secondary chain, all the 
preceding holds on that secondary chain may need their 
cumulative hold fields updated. A check is made to see 
if the removal of the hold affects the cumulative hold 
value. The hold of the freed hold record is used as an 
AND mask with its cumulative hold field. The result is 
then compared with the hold, and if they are equal, the 
chain’s cumulative hold fields need not be updated. 


If the cumulative hold field must be updated, the 
cumulative hold of the hold record to be freed is moved 
to the previous hold record. If the freed hold record was 
last on the secondary chain, this field is set to zero. 


If the updated hold record is the head of the secondary 

chain, all the records on the secondary chain are up to 

date. If the updated hold record is not the head of the 

secondary chain, it may not be necessary to continue 

updating the cumulative hold fields. The hold fields of 

the currently updated hold record and the freed hold 

record are compared. If the result of ANDing these two 

values equals the hold of the hold record freed, the OR 

value does not change and there is no need to continue ' 
the updates. If they are not equal, this hold record's Jo 
hold field and cumulative hold are ORed and placed in 

the cumulative hold field of the previous hold record and 

processing continues as stated at the beginning of this 

paragraph. 


Programming Note: All activity on the secondary chain is 
currently implemented in VMC, but the operation is 
nullified. Control is passed by a second chain search 
exception when it is determined that a second chain 
must be searched. The chain is marked busy and 
parameters are passed through the checkpoint area in 
the TDE. Bytes hex C2 and hex C3 in the HMC 
checkpoint area hold the index to the hold record at the 
beginning of the secondary chain. The second and third 
operands are unchanged; however, the first operand 
may have been altered if the primary chain search was 
interrupted. A freed hold record is placed on the 
available hold record chain with the Return Available 
Hold Record instruction. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Requested free was allowed. 
1 == 
2 oe 
3 Continue searching hold chain. 


Carry: Not applicable. 


Boundary Requirements: The second-operand hold 
request block must be halfword aligned; otherwise, a 
specification exception is recognized and the operation 
is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Chain conflict 

— Descriptor access: Busy 
— Effective address overflow 
— End of chain 

— Second chain search 

— Specification 
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FHRF Example 


A hold of hex 02 is to be dropped for an object located 
at hex 8001 1803 0000. Three holds exist on the same 
primary chain: two from another TDE and one from the 
current TDE which ts to be freed. 


The address of the obejct to be freed has been loaded 
into register hex C and register hex D points to an area 
that contains the 6-byte object (usually an object but 
may be a group of bits or bytes) address and the 2-byte 
hold request block. 


After executing the FHRF instruction, storage would look 
like: 


Op |B,| B, |B, D, 
47 B;C|D 006 
O Bit 8 12 16 20 31 


Assembler: FHRF B,, B3, D2(B2) 


Machine: 47BC DO06 


Before After 
B,(B): XxxXxX XXXX  XXXX 0801 OCOO 0050 (TDE that requested hold) J 
B.(D): 0801 D200 2200 0801 D200 2200 (pointer to hold request block) 
B3(C): 0801 1803 0000 0801 1803 0000 (object address) 


Storage — Before 











TDE 
? TDE l|dentifier 
Descriptor 9002 
0 Bytes 2 94 96 
Control Address Table Hash Table 
100 0088 
100 0092 0801 OCOO 0060 0005 
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0801 OCOO 0000 


10 
First hold 
record to be 20 
checked 30 
40 
50 


First available 
hold record —»> 60 


70 


~. 


0801 D200 2206 





Hold Records—Before 


2 Primary Secondary | Cumulative y . 
Object Address | TDE | Guain | Chain Hold Field | ~"“S* 









0801 1801 0000 
0801 1802 0000 
0801 1803 0000 
0000 0000 0000 











Hold Record 
Available 






Storage 


0/8 2/A 4/C 6/E taken off the chain. This is indicated by the TDE 


The hold record at address hex 8001 OCOO 0050 was 


0001 requesting the hold now showing as not used (hex OOO). 


1800 0000 0102 Note: Any of the hold records may be in any one of 


2048 possible chains. 


Hold Request Block 
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Storage — After 


Control Address Table Hash Table 





100 0088 
100 0092 





0801 OCOO0 0050 





0003 


Hold Records — After 


0801 OCOO 0000 


10 

20 

30 0801 1801 0000 

40 0801 1802 0000 

50 0801 1803 0000 

60 

70 

80 poenecers Available 


Now Available 


Chain 
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FUNCTION CALL DOUBLE (FNC2) 


Instruction Description 


The function call mechanism is used to call the function 
routine selected by the index in the I-instruction field. 


Format: SS 


ife| oo je) oo 
8 12 


0 Bits 16 20 32 36 47 


Operation: The index is used to access an entry in the 
FRAT (function routine address table) to determine 
where the function routine is located. Registers 0, 1, and 2 
and the IAR are saved in the current stack entry prior to 
that routine. 


Using the address found in base register 3, the current 
stack entry is accessed to determine if its storage 
capability will allow for the storage of up to 128 bytes. 
That capability is calculated by subtracting the offset of 
the current stack entry from the first halfword of the 
stack entry (that halfword pointing to the next stack 
entry). 


The stack entry is used to save the following: 


e Base register O in bytes 122 (hex 7A) through 127 
(hex 7F) 


¢ Base registers 1 through 2 in bytes 24 (hex 18) 
through 35 (hex 23) 


e Updated IAR (instruction address register) in bytes 
120 (hex 78) and 121 (hex 79) 


After the registers are saved into the stack entry, the 
effective address of the first operand is loaded into base 
register 1, the effective address of‘the second operand 
is loaded into base register 2, and the IAR and base 
register O are loaded with data from the function routine 
address table. The IAR is set to the 2-byte instruction 
address, and the base register O is set to the 6-byte 
function address, according to the following procedure: 
the I|-field is multiplied by 10 (hex A); that product is 
added to the address of the FRAT, located at bytes 
162-167 (hex A2-A7) in the CAT (control address 
table). The resultant address locates a 10-byte entry for 
a function routine. The first 2 bytes of the indexed 
FRAT entry are loaded into the IAR, and the next 6 
bytes are loaded into base register 0. The last 2 bytes 
are ignored. A branch is then taken to the address that 
was formed by concatentating the upper 4 bytes of base 
register O and the 2 bytes of the IAR. 


The effective addresses of the first and second 
operands are computed and checked for effective 
address overflow exceptions. No attempt is made to 
access the first and second operands, and they remain 
unchanged in storage. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: If the new values of the IAR 
and/or base register O are not halfword aligned, a 
specification exception is recognized and the instruction 
is suppressed. If the FRAT is not halfword aligned or 
the stack entry is not doubleword aligned, a 
specification exception is recognized and the operation 
is suppressed. If the FRAT crosses a segment 
boundary, an effective address overflow exception 
occurs and the instruciton is suppressed. 
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Program Exceptions: 


Addressing 

Address translation 

Effective address overflow 

Specification: 
FRAT not.halfword aligned 
FRAT ENTRY JAR value not halfword aligned 
FRAT entry BO value not halfword aligned 
Stack entry not doubleword aligned 
Stack entry less than 128 bytes long 


FNC2 Example 


Op I, 
A8 00 
8 


O Bits 





B, D, B, D, 
7 456 4 Aco 
16 20 32 36 47 


Assembler: FNC2 D, (B,), Dz (Bz), I3 
Machine: A800 7456 4A00 

Before After 
B(O): 0000 1111 0000 AAOOD OOAA 0000 
B(1): 0101 0101 1000 0707 0707 1567 
B(2): 0202 0202 2000 0404 0404 4E44 
B(4): 0404 0404 4444 0404 0404 4444 


B(7): 0707 0707 1111 0707 0707 1111 


IAR: 0800 1234 
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Stack Entry Before Data 








4100 
4000 


4008 
4010 
4018 
4020 
4028 
4030 
4038 
4040 
4048 
4050 
4058 
4060 
4068 
4070 
4078 


address = hex 
0303 0303 4000 


= 128 Bytes 


Next stack entry 


address = hex 
| 0303 0303 4100 | 


Stack Entry After Data 


4018 | 01010101 1000 0202 
4020 | 0202 2000 

4028 

4030 

4038 

4040 

4048 

4050 

4058 

4060 

4068 

4070 

4078 | 0806 0000 1111 0500 


See 5 


Doubleword Boundary 







8 Bytes 





<7 
ULM IUI;/'!]™74:’0@ E@@lldddd0 
UY IY]_ JM=@”00€@0@0€6’ 
OY I/]]]V ] II] H]YTJ_ 
MI 
CLYYLY@- MEX YJ )0700- 
ULI]L=]: MU] Y=@- 
WY YI] | EXXTWVWUXYC| | 0 
WY LY]_: JIE=X:_ LELY/=YE/ 
MLL LLL 





NN * 





\ 






WN 
SN 







WW 







Control Address Table 







address = hex 
0000 0100 0000 


address = hex 
0000 0100 00A2 






ae... 
4 0010 0200 0800 


- 














Function Routine |, field indexes to one 
Address Table of these 256 entries: 
address = hex E 0 
0010 0200 0800 ae 

Entry 1 

Entry 2 

—__—_————. 10 Bytes 

address = hex Entry 7 






risk [a | Fog 
1294 | AADOOOAA 6000 


0010 0200 0846 





| | Entry 255 
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GRANT HOLD RECORD (GHR) 


Instruction Description 


The GHR instruction is designed to be a continuation of 
a Grant Hold Record First instruction that was 
interrupted. Therefore, the execution is almost identical 
except for some initial conditions. The GHR instruction 
assumes that the hold record chain has been marked 
busy by a previous Grant Hold Record First instruction 
and instead of using an object address and the hash 
table to locate the first hold record to check, the GHR 
instruction assumes the address of a hold record is 
loaded in a register. 


The GHR instruction also checks for pending interrupts 
during execution. When the GHR instruction terminates, 
it is necessary to check the condition code to determine 
if execution completed or if the operation was 
interrupted and must be continued again by reexecuting 
the GHR instruction. 


Format: RS 


0 Bitt 8 12 16 20 31 


Operation: The first-operand hold record and 
succeeding hold records are checked to see if the 
second operand hold request can be granted. The 
outcome of this check is: to grant the hold request, to 
signal that a conflict exists, or to indicate that further 
hold records on the chain of the third-operand object 
must be checked. In all three cases, the first-operand 
base register is updated to the address of the 
appropriate hold record. 
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A 4096-byte HHT (hold hash table) is accessed. Its 
address is in bytes hex 8A-8F of the control address J 
table. This HHT address is set at IMPL (initial 

microprogram load) to point to the first byte in the page. 

The first AHR (available hold record) is also accessed 

using the AHR address in bytes hex 92-97 of the 

control address table. 


The instruction functions the same as the Grant Hold 
Record First instruction except for the following 
differences. The address of the first hold record to be 
checked is found in the first-operand base register 
instead of by hashing the third-operand object address 
and going thrrough the hold hash table. This first hold 
record is not the first on the chain, so its busy flag is 
not checked; thus no descriptor access busy exception 
can occur in this instruction. 


Since this instruction checks groups of hold records 
starting within the object hold chain, it does not set the 
chain busy flag in the first hold record of the chain 
when condition code 3 is set (the flag is assumed to 
have been set by the execution of a preceding Grant 
Hold Record First instruction). However, when condition 
code O exit is used, it goes back to this first hold record 
in the chain and resets the record’s busy flag (bit 5 of 


the first byte). ) 


Overflow and Sign Code: Not applicable. 


Condition Code: Programming Note: If a program exception occurs, the 
busy flag is not reset. 


O Requested hold was allowed. 

1: aie 

’ ala GHR Example 

3 Continue searching hold chain. 
[ses [eic|p| 6 
O Bits 8 12 16 20 31 


Carry: Not applicable. 


Assembler: GHR B,,B,,D,(B,) 
Boundary Requirements: The second-operand hold 


request block must be halfword aligned; the first Machine: 56BC DOO6 
available hold record must be quadword aligned; and the 
first-operand hold record must be quadword aligned. If See the GHRF instruction example. 


any of these requirements is violated, specification 
exception is recognized and the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Chain conflict 

— Effective address overflow 
— End of chain 

— Second chain search 

— Specification 
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GRANT HOLD RECORD FIRST (GHRF) 
Instruction Description 


The GHRF instruction conditionally adds entries to a list 
of hold records that contain a 6-byte object address, a 
hold byte, the identification of the TDE (task dispatching 
element) that requested the hold on the object, and the 
chain address to the next hold record on the hold record 
chain. The addition of new entries is conditional 
because each grant request specifies a test byte as well 
as a hold byte. If an existing hold record has a hold on 
the specified object matching any bit in the test byte, 
and the existing hold was requested by a different TDE, 
then an exception occurs and the new request is not 
granted. 


The starting point for the search of the hold record list 
is found by hashing the 6-byte object address specified 
in the third operand. An entry in a hold hash table 
points to the first hold record to be checked. Each hold 
record contains the index to the next hold record to be 
checked. As each hold is checked, its 6-byte address is 
placed in a register. The last entry on a chain is 
indicated by a flag bit in the hold record. The address 
of the hold hash table is located in the control address 
table. When a new hold record is to be added to a 
chain, the record is obtained from a chain of available 
hold records. The starting point for this chain is an 
address in the control address table, and the entries are 
chained the same way as hold records. 


While this instruction is executing it periodically checks 
for pending interrupts. If an interrupt is pending, the 
condition code is set (the busy flag is set for this hold 
record chain) and execution of the GHRF instruction 
ends. Execution can then be continued by the Grant 
Hold Record instruction. 


Format: RS 


O Bit 8 12 16 20 31 
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the third-operand object are checked. The outcome of 
this check is: to grant the second-operand hold request, 
to signal that a conflict exists for that request (unless 
hold request block byte 1 = 0), or to indicate that further 
hold records on the chain must be checked. In all three 
cases the first-operand base register is loaded with the 
address of the appropriate hold record. If the hold 
request block byte 1 is zero, the first-operand base 
register is unchanged. 


Operation: The hold records in the hold record chain of 


The address of the 4096-byte hold hash table is 
accessed in bytes hex 8A-8F of the control address 
table. This HHT (hold hash table) address was set by 
IMPL (initial microprogram load) to point to the first byte 
in the page. The first AHR (available hold record) is 
accessed using the AHR address given in bytes hex 
92-97 of the control address table. 


The third-operand register contains an object address. 
The 6-byte effective address is hashed to create a 
2-byte index into the hold hash table. If the chain is 
empty (contains no hold records) the hold hash table 
entry is all zeros. In this case, the hold requested by the 
second operand can be granted. (See Granting a Hold 
for how a hold is granted). 


If the hold hash table entry is not all zeros, the indexed J 
hold record is accessed. The 2-byte hold hash table 
entry is multiplied by 16 and concatenated to the right 
of the high-order 28 bits of the AHR (available hold 
record) address, found in the control address table, to 
point to the first hold record on the chain. These bits of 
the AHR point to the start of the hold record area. The 
hold record's chain-busy flag (byte 0, bit 5) is checked. 
If the chain busy flag is set (indicating chain busy), the 
first operand register is unchanged, a descriptor-access 
busy occurs, and the operation is nullified. 





If the chain busy flag is not set, hold records are 
checked for a hold conflict; the figure below indicates 
the number of records that can be checked. A conflict 
or end of chain in any hold record prohibits checking 
additional hold records. If the initial or previous groups 
of hold records has been checked without determining if 
the requested hold can be granted, a check is made for 
pending interrupts. If none are pending, additional 
groups of records are checked. If an interrupt is 
pending, it is handled the same as in a page fault. The 
instruction finishes as follows. 









Records rr 


Models tnt _Aaton 


The condition code is set to 3, the first-operand register 
is loaded with the address of the next hold record in the 
chain, the chain busy flag (bit 5 of the first byte) in the 
first hold record for this object chain is set, and the 
operation is completed. 






The hold chains are set up in a dual chain structure. The 
primary chain consists of those hold records with hash 
synonyms. The secondary chain has all hold records 
with equal object addresses. 


Primary Chain Search 


Each hold record is checked as follows. The 6-byte 
object address field of the hold record (bytes 2-7) is 
compared with the third-operand register contents. If 
this field does not match (indicating the hold record is 
intended for a hold hash synonym of this object), the 
hold EOC flag (bit 6 of the first byte) is checked. If this 
EOC flag is set; the hold requested by byte 1 of the 
second-operand hold request block may be granted (see 
Granting a Hold in this instruction description). If the 
EOC flag is reset, a check is made to see if pending 
interrupts must be checked. If it is, pending interrupts 
are checked as described in the preceding paragraphs. 
If not, the next hold record in this chain (whose record 
index is found in bytes hex A and hex B of the current 
hold record) is accessed and checked as described 
earlier in this paragraph. 


If the comparison of the object address fields of the 
preceding paragraph results in a match, the hold test 
field (byte O from the second-operand hold request 
block) is compared with the hold field (byte 1) of the 
current hold record. If any corresponding bits in these 
fields are both ones, a potential conflict exists and the 
hold field is compared to hex F8. If equal, the hold is an 
exclusive hold and no other holds can be placed on this 
object; a conflict has arisen (see Conflicts in this 
instruction description). If a potential conflict exists and 
the hold is not an exclusive hold, the TDE identifier field 
(byte 8-9) of the hold record is compared with the TDE 
ID field in bytes hex 92-97 of the current TDE. If these 
TDE IDs do not match, a conflict has arisen. 


If no conflict was detected, the head of secondary chain 
bit is checked. If this hold record is not the head of 
secondary chain, the hold may be granted (see Granting 
a Hold in this instruction description). If there is a 
secondary chain, the cumulative hold field is checked 
with the hold test field. If any corresponding bits are 
set, a potential conflict exists on the secondary chain 
and the secondary chain must be searched. If there is 
no potential conflict on the cumulative hold field, the 
hold may be granted (see Granting a Hold in this 
instruction description). 


Secondary Chain Search 


The secondary chain is searched using the chain field 
(bytes hex C and hex D) of the hold record. Object 
addresses do not need to be checked because they are 
all equal. The hold test field (byte 0) of the second 
operand hold request block is compared with the hold 
field (byte 1) of the current hold record. If any 
corresponding bits in these fields are set, a potential 
conflict exists and the TDE identifier field is compared 
with the TDE identifier field of the current TDE. If the 
TDE identifiers do not match; a conflict has arisen. If 
the TDE identifiers match, it might not be necessary to 
continue searching the secondary chain. This hold 
record’s cumulative hold field is checked. If there are no 
corresponding bits in these fields that are both set, the 
hold can be granted. If any corresponding bits in these 
fields are set, a potential conflict exists and the second 
chain search continues with the hold record pointed to 
by bytes hex C and hex D of the current hold record. If 
the end-of-secondary chain is reached (bytes hex C and 
hex D equal QO) before a conflict arises or a hold is 
granted, a specification exception is presented. 
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Granting a Hold 


When it is determined that the requested hold may be 
granted, the HRB hold field (byte 1 of the hold request 
block) is checked. If it is all zeros, the new hold record 
is not created and chained, the TDE count field in bytes 
hex 96-97 of the TDE is not incremented by 1, and the 
first-operand register is not loaded. However, the 
condition code is set to zero and the operation is 
completed. If the HRB hold field is not all zeros, the 
requested hold is granted as follows. A hold record is 
obtained from the AHR (available hold record) chain 
using the AHR address contained in the CAT. If this is 
the last AHR (its EOC flag set), the first-operand 
register is unchanged, an end-of-chain program 
exception occurs, and the operation is nullified. 


If this is not the last available chain record, the acquired 
hold record fields are filled in with pertinent data and 
the hold record is chained into the front of the object 
hold chain. Byte O (flags) of the acquired hold record is 
reset. Byte 1 (HRHOLD) is filled from HRBHOLD (byte 1 
of the hold request block). Bytes 2-7 (HROBJ) are filled 
from the contents of the third-operand base register. 
Bytes 8-9 (HRTDE) are filled from the task identifier 
halfword field (bytes hex 94-95 from the current TDE). 
Bytes hex A-B (HRCHN) are filled from the hash table 
entry for this object chain. The HRCHN value from the 
acquired hold record is multiplied by 16 and the 
resultant 20 bit value is loaded into the low order 20 
bits of the AHR (available hold record) address field in 
the control address table. The address of this acquired 
hold record is converted to a 2-byte record index and is 
moved to the hold hash table entry for this object chain. 
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at the top of the chain by linking the rest of the chain to 
it. The appropriate hash table entry value is placed into 
this new record (bytes hex A and hex B). The hash 
table entry is then filled with the index pointing to this 
new hold record. If other hold records already exist for 
this object, the new hold record is marked 
head-of-secondary chain (byte 0, bit O is set). The 
secondary chain is linked to this hold record by placing 
the index (address) to the previous head-of-secondary 
chain into bytes hex C and hex D of the new hold 
record. The new hold record’s index (address) is placed 
into bytes hex A and hex B of the hold record that was 
previously the head of the secondary chain. (This hold 
record’s head-of-secondary chain bit is reset.) The 
cumulative hold field is generated, by ORing the hold 
and cumulative hold of the previous head of this 
secondary chain, and then placed into bytes hex E of 
the new hold record. This previous head-of-secondary 
chain is then removed from the primary chain by moving 
its chain pointer in bytes hex A and hex B and the EOC 
bit (byte 0, bit 6) to the same bytes in the previous hold 
record on the primary chain. However, if this previous 
head-of-secondary chain was the first hold record on 
the primary chain, then the value that was originally in 
bytes hex A and hex B is moved to bytes hex A and hex 
B of the acquired hold record, updating the primary Jo 
chain pointer again. If this new hold record is the only 
hold record in its primary hash chain (hash table entry 
was zero), the EOC flag is set. The TDE hold count field 
in bytes hex 96 and hex 97 of the TDE is incremented 
by 1, the first operand base register is loaded with the 
address of the new hold record, and the condition code 
is set to 0. 


If no other record exists, the new hold record is placed ) 


Conflicts 


When a conflict has arisen, the chain busy flag (byte 0, 
bit 5 in the first hold record in the chain) is set, the first 
operand register is loaded with the address of this 
conflicting hold record, a chain conflict exception is 
signaled, and the operation is nullified. 


Programming Note: All activity on the secondary chain is 
currently implemented in VMC. The chain is marked 
busy and parameters are passed through the checkpoint 
area in the TDE. A second chain search exception is 
issued and the operation is nullified. 


Checkpoint Area 
(Hex Bytes) 
C2 and C3 Hash table entry offset. 


C4 and C5 An index to the hold record 
just prior to the hold record 
at the beginning of the 
secondary chain. (A value of 
O indicates the head of 
secondary chain is also first 


on the primary chain.) 
C6 and C7 


An index pointing to an 
available hold record. (The 
hold record is removed from 
the available hold record list 
when the second chain 
search exception is present.) 





Overflow and Sign Code: Not applicable. 


Condition Code: 


Requested hold was allowed. 


WN Oo 


Continue searching hold chain. 


Carry: Not applicable. 


Boundary Requirements: The second-operand hold 
request block must be halfword aligned, and the first 
available hold record must be quadword aligned. If one 
of these requirements is not met, a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Chain conflict 

— Descriptor access: Busy 
— Effective address overflow 
— End of chain 

— Second chain search 

— Specification 
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GHRF Example 
) 
A hold of hex 02 is being requested for hex 8001 1803 
0000. The test byte specifies hex 01, so only a previous 
hold of hex 01 is considered a conflict. Two holds from 
a different TDE already exist on the same hold record 
primary chain. 
The value for the hold has been loaded into register hex 


C. Register hex D points to the 6-byte value that 
precedes the hold request block. 


ele e) oe 
46 B;C 006 
O Bitt 8 12 16 20 31 
Assembler: GHRF B,, B3, D2 {B2) 
Machine: 46BC DOOG6 
Before After 
B,(B): xxxx xxxx xxxx 0801 OCOO 0050 
B.(D): 0801 D200 2200 0801 D200 2200 
B3(C): 0801 1803 0000 0801 1803 0000 J 


Storage — Before 










TDE 
Descriptor TDE Identifier 
0002 
0 Bytes 2 94 96 
Control Address Table Hash Table 
100 0088 
100 0092 0801 OCOD 0050 0003 
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0801 OCOO 0000 


: 10 
irst Hold 

Record on oa 
the Chain —> 30 


First Available 40 
Hold Record > 50 


60 
70 


0801 D200 2206 


Hold Records — Before 


: Primary | Secondary | Cumulative 


End of Chain 











02 0801 1801 0000 | 0001 
0 84 0801 1802 0000 | 0001 
00 02 0000 0000 0000 | 0000 
00 00 0000 0000 0000 | 0000 












( 
Hold Record 
Available 





Storage 


0/8 2/A 


1800 0000 0102 


Hold Request Block 
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Storage — After | 


Control Address Table Hash Table 
00 
00 
00 
00 


+ ———~«~S 










100 0088 


100 0092 0005 


0801 O0COO 0060 







Hold Records — After 


: Primary | Secondary | Cumulative 


00 
00 
00 
00 





0801 OCOO 0000 
10 








20 

30 0801 1801 0000 0000 
40 0801 1802 0000 0000 
50 0801 1803 0000 0000 
60 0000 0000 0000 0000 


70 
80 
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HASH AND VERIFY VIRTUAL ADDRESS (HVVA) 
Instruction Description 


The HVVA instruction provides support for linking virtual 
addresses (so the virtual address translator may resolve 
them) and for pinning and unpinning pages (to prevent 
storage management from stealing them). 


Format: SS 


8 


0 Bits 12 16 20 32 36 47 


Operation: 


The instruction has varying results depending on the 
contents of the second operand, which is treated as a 
6-byte address in storage. 


e If the storage operand contains a V=R address, the 
condition code is set to 3 and the instruction ends. 
The immediate byte of the instruction is ignored. 


e If the storage operand contains a virtual address, the 
address is hashed by the VAT (virtual address 
translator) microcode. The resulting 2-byte hash 
table class is placed in the left 2 bytes of the first 
operand. 


e If the virtual address represented by the storage 
operand is not found by the VAT microcode, 
condition code 2 is set and the instruction ends. The 
immediate byte is ignored. 


e If the virtual address represented by the storage 
operand is successfully translated, the PD (primary 
directory) entry valid bit is checked. If it is off, 
condition code 1 is set. The immediate byte is 
ignored. The PD entry identifier is formed and set in 
the right 2 bytes of the result. 


e If the virtual address represented by the pointer is 
successfully translated and the PD entry valid bit is 
on, condition code zero is set. The immediate byte is 
interrogated. The PD entry identifier is formed and 
set in the right 2 bytes of the result. The action 
taken for the immediate byte is as follows: 


I, Bits 

12 = 13 = Acticn 

0 0 Instruction ends; pin 
count in PD entry 
unchanged 

1 0 Pin count in PD entry 
incremented 

1 1 Pin count in PD entry 


decremented 


Bits 14 and 15 are not used. The pin count is 1 byte, 
unsigned. 


After execution of the HVVA instruction the bits of the 
first operand have the following meanings: 


Bits Contains 


0-15 Hash table entry index value 
16-31 Primary directory entry index 


If the primary directory entry is not present, bits 16-31 
are unchanged. 


Overflow: A machine check occurs if the increment or 
decrement operation to the pin count causes an 
overflow or underflow respectively. 


Sign Code: Not applicable. 
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Condition Code: 


OQ Primary directory entry exists and is valid 

1 Primary directory entry exists and is invalid 
2 Primary directory entry does not exist 

3 The second operand is a V=R address 


Carry: Not applicable. 


Boundary Requirements: The first operand must begin 
on a word boundary and the second operand must 
begin on a halfword boundary. Otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: The PD entry may be found by 
multiplying the second halfword by 16, ignoring any bits 
carried out of the halfword, and adding the resulting 
halfword to the primary directory address in the control 
address table. The address of the hash table entry may 
be found by multiplying the first halfword by 2, ignoring 
any bit carried out of the halfword, and adding the result 
to the hash table address in the control address table. 
(In both cases the condition code must indicate that the 
halfword[s] are valid.) 
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formed. The result of hashing [Ej is saved in the first 2 
bytes of the result. Hash table index hex 0050 
indicates the first PD entry currently containing a virtual 
address of that hash index. 


The hash index [[J for address hex C001 CEOO 0400 is ) 


PD entry index hex OOCE [EJ does not contain the 
requested address but contains a similar one that 
hashes to the same hash index. 


Since the next PD entry index [Mf field is not hex 0000 
(end-of-chain), at least one more member of the hash 
class is present. Index hex OOD1, turns out to be the 
address searched for. If index hex 0O0D1 had not been 
hex C001 CEQO 0400 and had contained end-of-chain 
for its next PD entry index, the HVVA microcode would 
have (1) concluded that no more PD entries contained 
members of hash class hex 0050 and that hex C0Q0O1 
CEOO 0400 was not resident at this time, and (2) set the 
condition code to 2 and ended the instruction. 


The second 2 bytes of the result 6 | area are set to the 
primary directory entry found. 


Since the valid bit (leftmost bit of the sixth byte of 

the code address) is on, the page is addressable. If it 

was off, the condition code would have been set to one ' 
and the instruction ended. » 


Since the immediate field says increment pin count and 
the page is resident and valid, the pin count is 
incremented from zero to 1. The condition code is set 
to zero. The instruction completes. 


HVVA Example 


Storage — Before 





QO Bit 8 12 16 20 32 36 47 


OOOF 2CB1 0000 
Assembler: HVVA D, (B, ), D> (Bz ye I3 


0012 ACOO 0000 | C001 CEOO 0400 


Machine: D808 4000 5000 . 


B, (4): OOOF 2CB1 0000 a 0050 





B, (5): 0012 ACO1 0000 


Hash Table Storage — After 


Offset PD Entry Index 0/8 2/A 4/C 6/E 


OO0AO OOCE OOOF 2CB1 0000 0050 0067 


ee mee” 


ed 
| a @ 


0012 ACOO 0000 Co01 CEOO 0400 





Index Offset 


Primary Directory 


0000 0000 Before After 


pS 


OOCE OCEO | D001 CE00 0400 00D1 Condition Code: = x 0 
—_—_—_———— 


00D1 0D10 | C001 CEO0O 0480 0001 
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INSERT TAGS (INTAG) 
Instruction Description 


Each quadword of the first operand is tagged if the 
corresponding bit of the second operand is set. 


Format: SS 


pas ie] oo jel o 
8 


0 Bits 16 20 32 36 47 


Operation: L, applies only to the number of bytes of the 
first-operand minus 1. 


The second operand is a halfword in storage with each 
bit (starting with the leftmost bit) containing the tagged 
indication for each of the quadwords of the first 
operand. When a zero bit is encountered, the 
corresponding quadword is untagged. When a 1 bit is 
encountered, the corresponding quadword is tagged. 
Any unused portion of the second operand is ignored. 
Any partial quadword at the end of the first operand is 
always untagged regardless of the tagged indication of 
the second operand. 
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Overflow and Sign Code: Not applicable. ) 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The second operand must start 
on a halfword boundary and the first operand must start 
on a quadword boundary. Otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


INTAG Example 





O Bits 16 20 32 36 


Assembler: INTAG D,/(L,,B,),D.(B,) 
Machine: A507 4000 5000 

B,(4): O20A B76C 0000 

B.,(5): O2OA B62A 0000 


Storage — Before and After 


020A B62A 0000 





As a result of this operation the words addressed by the 
first operand have their tag bits set as follows: 


020A B76C 0000 |! 020A B76C 0050 | ! 020A B76C QOAO | ° 020A B76C OOFO | ! 
04 54 A4 F4 
08 58 A8 F8 
OC | 5C AC FC 
10 }° 60 |! BO |! 
14 64 B4 
68 B8 
1c | 6C BC 
20 |! 70 |! Co |} 
24 74 C4 
28 78 C8 
2C 7C CC 
30 |° 80 |’ Do |! 
34 84 D4 
38 88 D8 
3C 8C DC 
40 |! 90 |° Eo |! 
44 94 E4 
48 98 E8 
4C 9C EC 
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INVALIDATE PRIMARY DIRECTORY ENTRY (IPDE) 
Instruction Description 


The IPDE instruction provides support for main storage 
management to steal page frames. Conceptually, pages 
are either resident (in main storage) or nonresident (in 
auxiliary storage only). However, while a page is in the 
process of being paged in from secondary storage or 
being eliminated from main storage, the page must be 
marked in some manner to account for such things as 
multiple address translation exceptions to the same page 
by concurrent processes or for attempts by processes to 
reference a page being stolen by storage management. 


Support for these conditions is provided by the notion 
of a valid PD (primary directory) entry. When a virtual 
address is inserted in the PD entry, the valid bit within 
that PD entry is left off until the page is read from 
auxiliary storage (or otherwise set to the correct 
contents). Any attempts to reference the address in this 
period generates address translation exceptions (page 
faults) just as if no PD entry contained the address. 


The address translation exception handler, however, by 
executing the HVVA instruction, distinguishes no PD 
entry from a PD entry with the valid bit off. This allows 
special case handling for multiple processes with 
concurrent address translation exceptions (since only 
one may actually insert addressability in the PD entry 
and perform the 1/0). 
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The valid bit may be turned on with any computational , 
instruction, such as the OR Byte Immediate instruction. J 
Turning it off, however, requires this instruction for three 

reasons: the use by |/O registers, pinning, and the LB 

(lookaside buffer). An |/O register is internally 

implemented such that an internal 4-byte rather than a 

6-byte form of the address is used. First, the 4-byte 

form addresses storage directly without going through 

virtual address translation when references stay within 

the current page. That is, the |/O register pretranslates 

the address. Thus, invalidating a page requires 

destroying addressability of any |/O registers addressing 

the subject page. Second, a page that is pinned by 

another user must always remain addressable and be 

addressed in the same page frame. Thus, if this page is 

pinned, this instruction cannot be allowed to complete 

successfully. Finally, the hardware LB must be purged 

of the entry for this PD entry, if present. This internal 

buffer is not addressable directly by any IMP 

instructions. 


The operand for this instruction is a PD entry identifier, 
which, when multiplied by 16 (ignoring any bits carried 
out of the halfword) and added to the base address of 
the PD, addresses the PD entry to be invalidated. 


Format: Sl ») 
12 


O Bits 8 16 20 31 


Operation: The pin count, bits 64-71 in the PD entry 
identified by the operand, is compared to zero. If it 
equals zero, the valid bit is then reset. In addition, if a 
copy of this directory entry is in the LB, the change bit 
in the LB entry is ORed into bit 42 of the PD entry. The 
entry is then removed from the LB. In addition, one of 
the PD |/0O use bits is checked. If the page was being 
used by |/O (bit 44=1), the page is removed from the 
|/O resolved address register. If the pin count does not 
equal zero, the PD is not changed and the LB is not 
checked. 


Bits 0-15 of the operand are used as the PD index 
value. If the index value specifies a directory entry 
containing a V=R address, a specification exception 
occurs and the operation is suppressed. A specification 
exception will not be presented if the index value 
specifies a directory entry beyond the range of directory 
entries. 


The high-order 4 bits (bits 0-3) of the PD index 
identified by the first operand are not used. The 
high-order bit (bit O) of the hash table entry index is not 
used to index the hash table. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 PD entry invalidated, pin count = 0 
1 PD entry not invalidated, pin count # O 
2 ae 
3 —_ 


Carry: Not applicable. 


Boundary Requirements: The operand occupies 2 bytes 
in storage and must begin on a halfword boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: The PD entry identifier is returned 
in bits 16-31 of the result from the Hash and Verify 
Virtual Address instruction. 
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IPDE Example 


Op B, D, 
83 4 320 


O Bits 8 12 16 20 31 


Storage — Before and After 







Assembler: IPDE D, (B,) 0000 0101 4500 


Machine: 8305 4320 


B,(4): 0000 0101 41E0 


>——@ 


PD Base Address: 0000 0101 O0O00 


Primary Directory 





0000 0101 0000 


8200 


8210 


Segment Identifier Status Index Reserved|EOC PINCNT Reserved 
0 Bits 31 40 47 | 48 59} 6062 | 63 64 71) 72 127 


0000 0000 0000 0000 0000 0101 0000 0101 | 0101 1100 | 1100 0000 | 11100100 0000 0000 0000 
2, \ 
ig 












The first operand addresses the PD entry index value. 
The processor multiplies the PD entry index value by 16, 
ignoring any bits carried out by the halfword. This 
halfword offset is then added [fj to the PD base 
address found in the control address table in order to 
address the PD entry [Ef 


The pin count fj is interrogated. If it had been nonzero, 
condition code one would have been set and the 
instruction ended. Since it is zero, the valid bit [J in the 
PD entry status field is set to zero and the virtual 
address [EM is used to interrogate the lookaside buffer 
and the |/O registers. If the lookaside buffer entry is 
present (in the processor), the change bit is ORed into 
the PD entry status field and the lookaside buffer entry 
is removed. All |/O registers pointing to the subject 
page are invalidated. 


Before After 


Condition Code: 1 8) 
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JUMP ON BITS OFF (JBF) 
Instruction Description 
The state of the first-operand bits selected by a mask is 


used to determine whether the jump is taken. A mask 
of zero results in no jump. 


Format: Rl 
or elo ay ae | 
O Bits 8 12 16 24 31 


Operation: The |, byte (immediate data) is used as an 
8-bit mask. The bits of the mask are made to 
correspond one for one with the bits of the byte register 
designated by r,. 


A set mask bit indicates that the register bit is to be 
tested. When the mask bit is reset, the register bit is 
ignored. When the selected register bits are all reset, 
the updated instruction address is incremented by the 
8-bit jump displacement, J,. The 8-bit jump 
displacement is added to bits 8-15 of the updated 
instruction address with both operands treated as 
unsigned binary quantities. Otherwise instruction 
sequencing proceeds with the updated instruction 
address. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: |f the sum of the updated instruction address 
and the jump displacement cause a carry, an effective 
address overflow exception occurs and the operation is 
suppressed. 


Boundary Requirements: The final instruction address 
must begin on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


JBF Example 


Op |r, l, J; 
5F 5 AF 2A 
O Bits 8 12 16 24 31 
Assembler: JBF r,,J3, Ip 
Machine: 5F50 AF2A 
Before Updated After 
r, (5): 50 — 50 


IAR: 3500 3504 352E 


Instruction Descriptions 
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JUMP ON BITS ON (JBN) 
Instruction Description 


The state of the first-operand bits selected by a mask is 
used to determine whether the jump is taken. 


Format: RI 
psc |ifol | 
0 Bits 8 12 #16 24 31 


Operation: A mask of zero results in no jump. 


The |, byte (immediate data) is used as an 8-bit mask. 
The bits of the mask are made to correspond one for 
one with the bits of the byte register designated by r,. 


A set mask bit indicates that the register bit is to be 
tested. When the mask bit is reset, the register bit is 
ignored. When all of the selected register bits are all 
set, the updated instruction address is incremented by 
the 8-bit jump displacement, J,. The 8-bit jump 
displacement is added to bits 8-15 of the updated 
instruction address with both operands treated as 
unsigned binary quantities. Otherwise, instruction 
sequencing proceeds with the updated instruction 
address. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 
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and the jump displacement cause a carry, an effective 
address overflow exception occurs and the operation is 
Suppressed. 


Carry: |f the sum of the updated instruction address 
) 


Boundary Requirements: The final instruction address 
must begin on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
Suppressed. 
Program Exceptions: 

— Address translation 

— Addressing 


— Effective address overflow 
— Specification 


JBN Example 


Op r, I, J, 
5E 5 AF 2A 


O Bits 8 12 16 24 31 


Assembler: JBN r,,J3, I. J 


Machine: 5E50 AF2A 
Before Updated After 
r, (5): AF _ AF 


IAR: 1500 1504 152E 





This page is intentionally left blank. 
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JUMP ON CONDITION (JC) 
Instruction Description 


The jump displacement in J, is added to the updated 
instruction address if the condition code is as specified 
by M,; otherwise, normal instruction sequencing 
proceeds with the updated instruction address. 


Format: Rl 


pve | [mt | 


0 Bit 8 12 16 24 31 


Operation: M, is used as a 4-bit mask. The 4 bits of 
the mask correspond, left to right, with the four 
condition codes (0, 1, 2, and 3). The jump is taken 
whenever the condition code has a corresponding set 
mask bit. 


The jump address is formed by adding the 8-bit jump 
displacement, J,, to bits 8-15 of the updated instruction 
address with both operands considered as binary 
unsigned quantities. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The updated instruction address 
must begin on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. If the sum of the jump offset and the 
updated instruction offset crosses a segment boundary, 
an effective address overflow exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 





C 


C 


Programming Note: The IMP instruction assembler uses 
the following extended mnemonics: 









Extended Standard Mask Code 


Mnemonic Meaning Mnemonic (Hexadecimal) 
4 Jump High 
nl Jump Low 


JE Jump Equal J 


C 
sc 
INE Jump Not Equal =| | 
JP 


C 
JC 


| 


Oo 











“| 0 


Jump Plus 


iT 





J Jump Minus JC 
JZ Jump Zero JC 
JNP Jump Not Plus JC 
JNM Jump Not Minus 


Cu 
Oo 





XH 
O 


Jump Ones 


OQ 


Jump If Mixed 


Cs 

N 
aX 
O 


= 
<= 
CK 
O 


KX 
O 


Jump If Zeros 


JNO Jump If Not Ones 





JC Example 


Op M J, 
4E 1 CO 
QO Bit 8 12 16 24 31 
Assembler: JC M,, J, 
Machine: 4E01 OOCO 
Before Updated After 
IAR: A200 A204 A2C4 


Condition Code: 3 — 3 
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LOAD (L) Program Exceptions: 


Address translation 
— Addressing 
Effective address overflow 


Instruction Description 


The second operand is placed unchanged into the 


register designated by the first operand. — Specification 
Format: RS L Example 
| 4 fejols.| op, pop [ajele] o 
O Bit 8 12 16 20 31 94 | 4 3 250 
O Bit 8 12 16 20 31 


Operation: See Instruction Description. 
Assembler: LB,,D (Bz) 


Overflow and Sign Code: Not applicable. Machine: 9440 3250 


Before After 
Condition Code: Not changed. 
B, (4): xxxx xxxx xxxx 0000 ABCD EFOO 


Carry: Not applicable. B,(3): 0020 2A00 0000 0020 2A00 0000 


Storage — Before and After 


Boundary Requirements: The storage operand must start 0/8 OIA A/C 6/E 
on a halfword boundary; otherwise a specification ' 
exception occurs and the operation is suppressed. 0020 2A00 0250 | 0000 ABCD EFOO 
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LOAD ADDRESS (LA) 
Instruction Description 


The address specified by B, and D, is loaded into the 
base register specified by B,. 


Format: RS 
53 |elole,| pv, 
O Bits 8 12 16 20 31 


Operation: The address computation follows the rules 
for address arithmetic. 


No storage references for operands take place, and the 


address is not inspected for an addressing exception. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: If the sum of the offset portion of B, and the 
displacement results in a carry, an effective address 
overflow exception occurs and the operation is 
suppressed. 


Boundary Requirements: None. 


Program Exception: Effective address overflow 


LA Example 
Op |B, B, D, 
53 3 4 BOO 
O Bits 8 12 16 20 31 


Assembler: LA B,,D,(B,) 
Machine: 5330 4B00 
Before After 
0000 EBOO OBOO 


B,(3):  xxxx XXXX  XXXXxX 


B.(4): 0000 EBOO 0000 0000 EBOO O000 


Instruction Descriptions 
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LOAD AND VERIFY TAGS (LVT) 
Instruction Description 


The LVT instruction provides support for loading the 
address value of a pointer into a base register. 
Verifications are performed on the specified storage to 
ensure that it does contain a pointer. Checks are 
performed to ensure that: 


e Boundary alignment is a 16-byte (quadword) multiple. 


e The hardware tags are on. 


e The pointer type is one of those specified as 
allowable on the instruction. 


e The pointer is resolved to an object. A pointer may 
contain an initial value, requiring it to be resolved. 


e The object addressed by the pointer has not been 
destroyed. 


Upon passing all of these verifications, the address 
value within the pointer is loaded into the base register 
providing addressability to the object for VMC 
instructions. The condition code is set as a result of the 
instruction to indicate the type of pointer that was 
accessed. 


Format: RS 


12 


O Bits 8 16 20 31 
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Operation: The address located in bytes hex A-F of the 
second operand is placed in the first-operand location. 


The following validity checks are made on the second 
operand: 


e The second operand must be tagged. 


e Bit 2 of the second operand must be zero. 


e Bytes 8 and 9 of the second operand must match the 


halfword in storage located at the address 
determined by taking bytes hex A, B, and C of the 
second operand and concatenating hex 00 0004 on 
the right. 


J 





The type of pointer (specified by bits 0-1 of the second 
operand) is verified to match with that allowed by |,. 


Bits O-1 specify the pointer type as follows: 


Second Operand 


Bits 0-1 


00 
01 
10 
11 


Decode Description 


1000 System pointer 
0100 Instruction pointer 
0010 Space pointer 
0001 Data pointer 
Description 


System pointer not allowed 
System pointer allowed 


Instruction pointer not allowed 
Instruction pointer allowed 


Space pointer not allowed 
Space pointer allowed 


Data pointer not allowed 
Data pointer allowed 


To verify the pointer match, the AND of the |, field with 
the decode of bits 0-1 must be nonzero. 


If any of the above checks fails, a verify exception 
occurs and the operation is suppressed. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 System pointer 
1 Instruction pointer 
2 Space pointer 
3 Data pointer 


Carry: Not applicable. 


Boundary Requirements: The second operand is a 
quadword and must start on a quadword boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
— Specification 

Verify 
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LVT Example 

Op I, |B, D, 

64 a2 OCO 
QO Bits 8 12 16 20 31 
Assembler: LVT Bi, D,(B2), I3 


Machine: 6453 20C0 


Before After 
B, (5): XXXX XXXxX xxxx 0001 2C00 5148 
B (2): 0001 5005 0000 0001 5005 Q000 
Condition Code: x 2 


The pointer is accessed through the base plus the 
displacement 1 | (the second operand) specified in the 
instruction. The type of pointer [Pj is verified to match 
with that allowed by the |, field of the instruction. In 
the example |, = 3 (space pointer allowed and data 
pointer allowed). If the type is not allowed, a verify 
exception occurs. 


The initial value indicator, bit 2, of the pointer Ej is 
checked for a value of zero. !f not zero, a verify 
exception occurs. A value of 1 can only occur for 
system and data pointers and indicates that they coritain 
a pointer to a name and must be resolved to the actual 
object. This resolution is done by a default exception 
handler for the verify exception. 


The segment group extender value 4 | in the pointer is 
checked against the extender value in the header of 
the segment group [MJ identified by bytes A-C [J of the 
pointer. If not equal, a verify exception occurs. (Equal 
means that the segment group is still being used to 
contain the same object that it contained when «he 
pointer was built.) 


The first oprand is updated with the address value from 
bytes A-F of the pointer. 
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The condition code is set to indicate the type of pointer 
accessed. In this example, it is set to 2 to indicate a ) 
space pointer. 


Pointer 
















0s 2/A 4/C_ 6/E 


0001 5005 00CO | 8000 0000 0000 0000 








OOOA 0001 


a 


2C00 5148 





Zeros (3 bytes) Catenated 


with Value from 
/ 


Feet a ati 
0001 2C00 0000 


Forms the Segment 
Group Address 


Pointer-Type Bits 





Storage — Before and After 


G 0/8 2/A 4/C 6/E 4 


0001 2C00 0000 xxxx xxxx OOOA 
Se ee! 





LOAD BYTE (LB) 
Instruction Description 


The second operand is placed unchanged into the 
register designated by the first-operand register. 


Format: RS 


74 |rjole| 
8 12 


0 Bits 16 20 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


LB Example 
Op |r, B, D, 
74 5 3 210 
O Bits 8 12 16 20 31 


Assembler: LB r,,D,(B) 
Machine: 7450 3210 


B, (3): 001B CDEO 0000 


Storage — Before and After 


001B CDEO 0210 





Before After 


r, (5): XX Ad 


Instruction Descriptions 
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LOAD BYTE REGISTER (LBR) 
Instruction Description 


The second operand is placed in the first-operand 
register. 


Format: RR 


4 tele 


O Bits 8 12 15 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 
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Carry: Not applicable. 


Boundary Requirements and Program Exceptions: None. 


LBR Example 


O Bits 8 12 15 


Assembler: LBRr,,r, 

Machine: 1434 
Before After 

r, (3): XX FF 


r2 (4): FF FF 


J 





LOAD BYTE REGISTER IMMEDIATE (LBRI) 
Instruction Description 


The second operand is placed into the register 
designated by the first operand. 


Format: RI 


O Bits 8 12 16 24 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


LBRI Example 


Op I, 

44 AY 
QO Bits 8 12 16 24 31 
Assembler: LBRIr,, Io 
Machine: 4450 A900 


Before After 


r, (5): XX AQ 
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LOAD HALFWORD (LH) 
Instruction Description 


The second operand is placed into the register 
designated by the first operand. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation ts suppressed. 
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Program Exceptions: 


Address translation 
Addressing 

— Effective address overflow 
Specification 


LH Example 


Op B, D, 
84 3 coo 
12 3 


O Bits 8 16 20 1 


Assembler: LH R,,D, (Bz) 
Machine: 8450 3C00 


B, (3): OOAF 0210 0000 


Storage — Before and After 


OOAF 0210 OCOO 


Before After 


R,(5): xxxx ABCD 





LOAD HALFWORD REGISTER (LHR) 
Instruction Description 


The second operand is placed in the first-operand 
register. 


Format: RR 


O Bits 8 12 15 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


LHR Example 


O Bits 8 12 15 
Assembler: LHR R,, R, 
Machine: 2434 

Before After 
R, (3): xxxx ABCD 


R2(4): ABCD ABCD 
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LOAD HALFWORD REGISTER IMMEDIATE (LHRI) 
Instruction Description 


The second operand is placed into the register 
designated by the first operand. 


Format: RI 


O Bits 8 12 16 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements and Program Exceptions: None. 


LHRI Example 


l, 
ABCD 


O Bits 8 12 16 31 


Assembler: LHRIR,, I, 
Machine: 5430 ABCD 
Before After 


R,(3): xxxx ABCD 


LOAD HASH TABLE ENTRY ADDRESS (LHTEA) 


Instruction Description 


The address of the hash table entry indexed by the 
second operand is loaded into the base register 
specified by the first operand. 


Format: RS 


0 Bits 8 12 16 20 31 


Operation: The second operand is used as the 2-byte 
hash table index value. The address of the hash table 
entry indexed by the second operand is formed by 
shifting the index 1 bit to the left, converting it from an 
index to an offset (bit 15 becomes zero). That offset is 
added to the original address of the hash table and 
loaded into the base register specified by the first 
operand. No storage reference is made for the hash 
table entry, and the high-order bit (bit 0) of the hash 
table entry index identified by the second operand is not 
used. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The second operand occupies 2 
bytes in storage and must begin on a halfword 
boundary; otherwise, a specification exception is 
recognized and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


LHTEA Example 

Op |B, D, 

83 8 074 
O Bit 8 12 16 20 31 
Assembler: LHTEA B,, D3 (B,) 


Machine: 8382 4074 


Before After 
B, (8): xxxx XXXX XXXX 0000 0102 0C42 
B2(4): 0000 0100 2480 0000 0100 2480 


Hash Table Address: 0000 0102 Q000 


Storage — Before and After 


0000 0102 24F4 


Instruction Descriptions 
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LOAD MULTIPLE (LM) 
Instruction Description 


A set of registers is loaded from the locations 
designated by the second-operand address. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The first-operand field identifies the first 
register to be loaded, and |, specifies the number of 
additional registers to be loaded. 


The storage area from which the contents of the 
registers are obtained starts at the location specified by 
the second-operand address and continues through as 
many locations as needed. 


The registers are loaded in the ascending order of their 
addresses, starting with the register specified by the 


first operand. The register addresses wraparound from 
hex F to 0. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The storage operands must 
each start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 
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Program Exceptions: 


Address translation J 


Addressing 
Effective address 
Specification 


LM Example 
D, 
200 
0 Bit 8 12 16 20 31 
Assembler: LM B,, 13, D2 (Bz) 


Machine: 95D4 4200 


B,(4): 0000 2A00 0000 


Storage — Before and After 


0000 2A00 0200 





Base 

Register Before After 
D Xxxx xxxx xxxx 0000 1234 5678 
E XXxXx XxxxXx xxxx Q000 2100 2A30 
F XXxx xxxx xxxx Q000 OA30 BC30 
0 XXXX XXXX xXXXX  3A20 FFF3 21A0 
1 XXxxX xxxx xxXxXxX  14BC DEFO 33A0 





LOAD MULTIPLE BYTE (LMB) 
Instruction Description 
A set of registers is loaded from the locations 


designated by the second-operand address. 


Format: RS 


76 tol ufe) 
8 12 


0 Bits 16 20 31 


Operation: The first-operand field identifies the first 
register to be loaded, and |, specifies the number of 
additional registers to be loaded. 


The storage area from which the contents of the 
registers are obtained starts at the location specified by 
the second-operand address and continues through as 
many locations as needed. 


The registers are loaded in the ascending order of their 
addresses, starting with the register specified by the 
first operand. The register addresses wraparound from 
hex F to 0. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


LMB Example 


Op D, 
75 000 
12 31 


0 Bits 8 16 20 


Assembler: LMB ri, ls, D, (B,) 
Machine: 7552 4000 


B, (4): 2A3C F1FA 0000 


Storage — Before and After 


2A3C F1FA 0000 





Byte 
Registers Before After 


5 XX 12 
6 XX 34 
7 XX 56 
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LOAD MULTIPLE HALFWORD (LMH) 
Instruction Description 
A set of registers is loaded from the locations 


designated by the second-operand address. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The first-operand field identifies the first 
register to be loaded, and |, specifies the number of 
additional registers to be loaded. 


The storage area from which the contents of the 
registers are obtained starts at the location specified by 
the second-operand address and continues through as 
many locations as needed. 


The registers are loaded in the ascending order of their 
addresses, starting with the register specified by the 
first operand. The register addresses wraparound from 
hex F to 0. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
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Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


LMH Example 


Op I, 
85 4 
O Bits 8 12 16 20 31 
Assembler: LMH R,,1;,D,(B,) 
Machine: 8504 0130 


B, (0): 0135 A210 0000 


Storage — Before and After 


0/8 2/A 4/C 6/E 
A1lA2 B1B2 = C1C2 


0135 A210 0130 0102 
D1D2 





Halfword 

Registers Before After 
0 0000 0102 
1 xxxx  ATA2 
2 xxxx B1B2 
3 xxxx C1C2 
4 xxxx D1D2 


LOAD PRIMARY DIRECTORY ENTRY ADDRESS 
(LPDEA) 


Instruction Description 


The address of the primary directory entry indexed by 
the second operand is loaded into the base register 
specified by the first operand. 


Format: RS 


O Bits 8 12 16 20 31 


Operation: 


The second operand is used as the primary directory 
index value. The address of the primary directory entry 
indexed by the second operand is formed by the shifting 
index to the left 4 bits, converting it from an index to an 
offset (bits 12-15 become zeros). This offset is added 
to the original address of the primary directory and 
loaded into the base register specified by the first 
operand. The high-order 4 bits (bits 0-3) of the primary 
directory index identified by the second operand are 
ignored and treated as zeros. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The second operand occupies 2 
bytes in storage and must begin on a halfword 
boundary; otherwise, a specification exception is 
recognized and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


LPDEA Example 
Op D, 
83 076 
0 Bit 8 12 16 20 31 


Assembler: LPDEAB,,D,(B,) 


Machine: 8361 4076 


Before After 
B, (6): xxxx XXxXX XXXX 0000 0101 0820 
B,(4): 0000 0100 2480 0000 0100 2480 


Primary Directory Address: 0000 0101 OOOO 


Storage — Before and After 


0000 0100 24F6 


Instruction Descriptions 
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LOAD PRIMARY DIRECTORY ENTRY ADDRESS 
REGISTER (LPDEAR) 


Instruction Description 


The address of the primary directory entry indexed by 
the second-operand halfword register is loaded into the 
base register specified by the first operand. 


Format: RR 


25 [elm 


O Bits 8 12 15 


Operation: The address of the primary directory entry is 
formed by shifting the second operand to the left 4 bits 
(bits 12-15 become zeros) to convert the address from 
an index to an offset. This offset is then added to the 
origin address of the primary directory; the resulting 
address is then loaded into the base register specified 
by the first operand. The high-order 4 bits (bit 0-3) of 
the primary directory index identified by the second 
operand are ignored and treated as zeros. No storage 
reference is made for the primary directory entry. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 


Carry: Not applicable. 
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Boundary Requirements: Not applicable. 
Program Exceptions: None. 


LPDEAR Example 
Fane 

25 
O Bits 8 12 15 
Assembler: LPDEAR B,, R2 
Machine: 2568 

Before After 

B,(6): XxxXxxX XXXX XXXX 0000 0101 0820 
R,(8): 0082 0082 


Primary Directory Address: 0000 0101 0000 





LOAD REGISTER (LR) 
Instruction Description 


The second operand is placed in the first-operand 
register. 


Format: RR 


O Bits 8 12 15 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


LR Example 


O Bits 8 12 15 
Assembler: LR B,, B2 
Machine: 1514 
Before After 
B,(1): xxxx xxxx xxxx O2A3 1234 5678 


B2(4): O2A3 1234 5678 0O2A3 1234 5678 
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LOAD SPACE OFFSET POINTER (LSOP) 


Instruction Description 


The 4-byte unsigned binary displacement identified by 
the second operand is added to the 3-byte unsigned 
binary space locator specified by the third operand. The 
resultant low-order 3 bytes are concatenated to the 
right of the high-order 3 bytes of the third-operand 
address; the result is placed into the first-operand base 
register. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The address computation is performed in the 
following manner. The space locator is a 3-byte binary 
field located at the storage address found by 
concatenating hex 00 001D to the right of the 
high-order 3 bytes (segment group identifier) of the 
third-operand address. That space locator is padded on 
the left with hex 00 to form a 4-byte binary 
displacement, and is added to the second operand. If 
the resultant 4-byte sum exceeds hex OOFF FFFF or 
causes an overflow, an invalid segment group address 
exception is recognized and the operation is terminated. 
The resultant segment group offset (low-order 3 bytes) 
is concatenated to the right of the segment group 
identifier (high-order 3 bytes) of the third operand 
address; the result is placed in the base register 
specified by the first operand. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Invalid segment group address 


LSOP Example 


B, B, D, 
8 2 020 
O Bits 8 12 16 20 31 
Assembler: LSOP B, D> (B>),B3 
Machine: 9386 2020 

Before After 
B, (8):  xxxx XXXX XXXx 00C1 BOOO O8A0 
B,(2): O00C1 BOOO 4BCO 00C1 BOOO 4BCO 


B3(6): 00C1 BOOO 0920 00C1 BOOO 0920 


Storage — Before and After 


00C1 BOOO 4BE0 
00C1 BOOO 001D 








MOVE AND SET TAGS (MVAST) 
Instruction Description 


The MVAST instruction provides support to build 
System/38 pointers from a 16-byte value in storage. 
Both the area for the pointers to be built (the first 
operand) and that for the source 16-byte value (the 
second operand) are ensured to be aligned on a 16-byte 
boundary. The second operand value is moved to the 
first operand as System/38 pointer (tagged) data. 


Format: SS 
O Bits 12 16 20 32 36 47 


Operation: The second operand is placed in the 
first-operand location with the first operand tagged. 
The second operand may or may not be tagged. 


If the two operands are the same quadword, then the 


effect is to set the tags with no change to the data. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Each operand is a quadword 
and must start on a quadword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


MVAST Example 


D, 
FOO 


0 Bits 12 16 20 32 36 47 


Assembler: MVAST D, (B,;), D2 (B2) 
Machine: B400 9006 4FQ0 
B,(9): 0001 OOFF FF7A 


B2(4): O5AC 0400 0010 


Storage — Before 


0001 OOFF FF80O 


O5AC 0400 OF10 





Each word has 


Storage — After tag set to 1 





0001 OOFF FF80 


O5AC 0400 OF 10 
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MOVE BYTE IMMEDIATE (MVBI) 
Instruction Description 


The second operand is placed in the first-operand 
location. 


Format: Sl 
joe | [af Do 
O Bits 8 16 20 31 


Operation: See Instruction Description. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


MVBI Example 

Op lL. D, 

9B 5C 1A0 
O Bits 8 16 20 31 
Assembler: MVBI D, (B;), I. 


Machine: 9B5C 31A0 


B,(3): OOAC 0003 0000 


Storage — Before 


OOAC 0003 01A0 


Storage — After 


OOAC 0003 01A0 








MOVE BYTE IMMEDIATE AND PROPOGATE 
(MVBIP) 
Instruction Description 


Each byte of the first operand is filled with the padding 
character, I,. 


Format: Sl 
pac | ciel on |. | 
O Bits 8 16 20 32 40 47 


Operation: See Instruction Description. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first operand must not 
cross a segment boundary; otherwise an effective 
address overflow occurs and the operation is 
suppressed. 


Program Exceptions: 
— Address Translation 


— Addressing 
— Effective Address Overflow 


MVBIP Example 

Op L, D, 

AC 05 C20 
O Bits 8 16 20 32 40 47 
Assembler: MVBIP D,(L;,B;), I, 


Machine: ACO5 3C20 F900 


B, (3): 1234 5678 0000 


Storage — Before 


1234 5678 0C20 





Storage — After 


0/8 2/A 
1234 5678 0C20 FOFQ9 -F9OF9 
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MOVE CHARACTER REGISTER (MVCR) 


Instruction Description 


The second operand is placed in the first-operand 
location. The length is variable and is found as the 
contents of the third-operand byte register. 


Format: SS 
O Bits 12 16 20 32 36 47 


Operation: Each operand field is processed left to right. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
leftmost byte of the first operand is coincident with or 
to the left of the leftmost byte of the second operand; 
otherwise, the overlap is destructive and the results are 
unpredictable. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 
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MVCR Example 


Op ve D. 
DB BCO 
O Bits 12 16 20 32 36 47 
Assembler: MVCR D, (B,), D2 (B2),r3 
Machine: DB60 32A0 4BCO 
r3 (6): 07 
B, (3): 000C AA1B 0000 
B,(4): 00OC AC1B 0000 


Storage — Before 


0/8 2/A 


XXXKX XXXX 


000C AA1B 02A0 
000C ACiB OBCO 1234 5678 





Storage — After 


0/8 2/A 
000C AA1B 02A0 1234 5678 
000C AC1B OBCO 1234 5678 





MOVE CHARACTERS (MVC) 
Instruction Description 


The second operand is placed in the first-operand 
location. 


Format: SS 
0 Bits 16 20 32 36 47 


Operation: Each operand field is processed left to right. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
leftmost byte of the first operand is coincident with or 
to the left of the leftmost byte of the second operand; 
otherwise the overlap is destructive and the results are 
unpredictable. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


MVC Example 


Op D, 
CB al BCO 


0 Bits 16 20 32 36 47 


Assembler: MVC D,(L;,B,), D2 (B2) 
Machine: CBO7 32A0 4BCO 
B, (3): 000C AA1B 0000 


B,(4): 000C AC1B 0000 


Storage — Before 


0/8 2/A 
000C AA1B 02A0 XXXX XXXX 
O0OC AC1B OBCO 1234 5678 





Storage — After 


0/8 2/A 
O00C AA1B 02A0 1234 5678 
000C AC1B OBCO 1234 5678 
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MOVE CHARACTERS AND TAGS (MVCAT) 
Instruction Description 


The MVCAT instruction moves data in storage while 
preserving System/38 pointers. Both operands are 
assumed to be aligned to the same position relative to a 
16-byte boundary. System/38 pointers completely 
contained in the second operand are preserved in the 
first operand. Partial System/38 pointers are copied 
from the second operand into the first operand, but they 
do not retain the pointer attribute (copied untagged). 
System/38 nonpointer data (untagged data) is copied 
from the second operand to the first operand. 


Format: SS 


jes | tial 2 |e) 
8 


O Bits 16 20 32 36 47 


Operation: The second operand may contain untagged 
data and/or tagged quadwords. If the first byte does 
not start on a quadword boundary, then that partial 
quadword is moved to the first operand untagged. If the 
last byte does not end on a quadword boundary, then 
that partial quadword is moved to the first operand 
untagged. All other quadwords are moved to the first 
operand with their associated tags. 


Each operand is processed left to right. The operands 
can overlap if the leftmost byte of the first operand is 
coincident with or to the left of the leftmost byte of the 
second operand; otherwise the overlap is destructive 
and the results are unpredictable. This unpredictability 
resulting from operand overlap can destroy valid pointers 
but cannot create invalid pointers. 
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Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: Both operands must be 
comparably aligned within a quadword; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 








MVCAT Example 


Assembler: MVCAT D, (L;, B;), D2(B>) 





Machine: B516 7000 2000 
0 Bits 16 20 32 36 


B, (7): 1F 
The partial System/38 instruction pointer (tagged) data 1(7): OO1F CBOO CDFD 


in the first 3 bytes of the second operand 1 is moved 
to the first 3 bytes of the first operand as nonpointer 
(untagged) data. 


B2(2): 0105 O07AA 700D 


The complete System/38 pointer in the next 16 bytes of 
the second operand [¥ is moved intact as a System /38 
pointer (tagged) into the next 16 bytes of the first 
operand. 


The next 4 bytes of nonpointer data in the second 
operand [Kl is moved intact as a nonpointer data into 
the next 4 bytes of the first operand. 


Storage — After 


6/E 
001F CBOO CDFD 00 }§=67052 EB (not 
tagged) 
CEOO 0000 0000 0000 PJ (tagged) 


8000 1537 815A 
CE10 FOC1 (not tagged) 


0105 07AA 700D 00 7052 Mi (tagged) 


7010 0000 0000 0000 qtagged) 
8000 1537 815A 


7020 FOC1 (Eq (not tagged) 
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MOVE CHARACTERS LONG (MVCL) 
Instruction Description 


The second operand is placed in the first-operand 
location. The remaining rightmost byte positions, if any, 
of the first operand location are filled with the padding 
character, contained in the |, field of the instruction. 


Format: SS 


8 


0 Bits 16 20 32 36 47 


Operation: The leftmost bytes of the first and second 
operands are located indirectly through addresses 
contained in storage. The first and second-operand 
addresses from the instruction identify an 8-byte field in 
storage. Bytes 0-1 of these 8-byte fields specify 1 less 
than the number of bytes in the operand location, and 
bytes 2-7 contain the addresses of the leftmost byte of 
the operands. 


Operand Address 
SID Offset 


Length 





0 Bytes 2 


The operation starts at the leftmost end of both fields, 
proceeds to the right, and ends when the end of the 
first-operand field is reached. If the second operand is 
shorter than the first operand, the remaining rightmost 
bytes of the first operand are filled with the padding 
character. 


If the 8-byte field associated with the second operand 
contains all zeros, the second operand is assumed to be 
of zero length and the first operand is completely filled 
with the padding character. If the 8-byte field 
associated with the first operand contains all zeros, the 
operation is completed with no data moved. 
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The execution of the instruction is interruptable (the 
operation can be suspended). When an interruption 
occurs after a unit of operation other than the last one, 
the IAR (instruction address register) is not advanced to 
the next instruction address, the length fields are 
decremented by the number of bytes moved, and the 
address fields are incremented by the same number, so 
that the instruction resumes at the point of interruption. 
if the operation is interrupted during padding, the length 
field for the second operand is zero, the address field 
for the second operand is set to contain all zeros, and 
the length and address fields for the first operand reflect 
the extent of the padding operation. 


At the completion of the operation, the length and 
address fields associated with the first operand contain 
all zeros. The length field of the second operand is 
decremented by the number of bytes moved and the 
address field is incremented by the same amount. The 
length and address fields associated with the second 
operand contain all zeros if the second operand is 
completely moved by the operation. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first and second-operand 
addresses from the instruction identify 8-byte fields in 
storage that begin on a word boundary and must not 
cross a page boundary; otherwise a specification 
exception occurs and the operation is suppressed. 
Neither data operand may cross a segment boundary; 
otherwise an effective address overflow exception 
occurs and the operation is suppressed. 


The operands can overlap if the leftmost byte of the 
first operand is coincident with or to the left of the 
leftmost byte of the second operand; otherwise the 
overlap is destructive and the results are unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


MVCL Example 


O Bits 


Op I, B, B. D, 
EB FF 3 3 BOO 
8 


16 20 32 36 


Assembler: MVCL D,(B,), D2 (Bz), |3 


Machine: EBFF 3100 3B00 


B, (3) and B, (3): 0001 1AB2 0000 


0001 1AB2 0100 
OBOO 


O2AC AC1B 2100 


312A F215 AOCO 


0001 1AB2 0100 
OBOO 


O2AC AC1B 2100 


312A F215 AOCO 


Storage — Before 


47 





Storage — After 
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MOVE HALFWORD IMMEDIATE (MVHI) 
Instruction Description 


The second operand is placed in the first-operand 
location. 


Format: Sl 
Lae | [olel _o | 4, 
O Bits 12 16 20 32 47 


Operation: See Instruction Description. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


10-278 


Program Exceptions: ) 


— Address translation 

— Addressing 

— Effective address overflow 
— Specification 


MVHI Example 
Op I, 
AB ABCD 
0 Bits 16 20 32 47 


Assembler: MVHID, (B;), I. 
Machine: ABOO 3250 ABCD 


B,(3): 002A O0A2 0000 


Storage — Before 


002A OOA2 0250 





Storage — After 


002A OO0A2 0250 








MOVE VIRTUAL PAGE WITH CORRECTED 
DOUBLE-BIT ERRORS SUPPRESSED (MVMC) 
(5382 MODELS ONLY) 


Instruction Description 
The second operand is placed in the first operand 


location. The IMPI processor must be in machine check 
mode or a machine check will occur. 


Format: RR 


1 [8/5 


O Bits 8 12 15 


Operation: Each operand field is processed left to right 
with tags. If a hard-hard double-bit main storage error 
occurs on the second operand during this operation and 
is corrected, the machine check will be suppressed. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The operands must be 
different main storage frames, page-aligned, and 512 
bytes long or a machine check will occur. The second 
operand address must be a V=V address or a machine 
check will occur. 


Program Exception: None. 


MVMC Example 


Op |B, 
1D 7 


O Bits 8 12 15 


Assembler: MVMC B., B, 


Machine: 1D74 


B,(7): 0000 0139 CAOO 


B,(4): OOOB DOGS 3600 


0000 0139 CAOO 


CBF8 


OOOB DO65 3600 


37F8 


0000 0139 CA0O0 


CBF8 


OOOB DO65 3600 


37F8 


Storage - Before 


Storage - After 
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MOVE NUMERIC TO NUMERIC (MVNN) 
Instruction Description 


The numeric half of the 1-byte second operand is 
placed in the numeric half of the 1-byte first operand. 


Format: SS 
(ea | fojs| o, |e| p, _ 
O Bits 16 20 32 36 47 


Operation: The numeric half of the byte is the rightmost 
4 bits. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
-— Effective address overflow 


MVNN Example 


Op B, D, 
BA 3 400 


0 Bits 12 16 20 32 36 47 


Assembler: MVNN D, (B, ), D>, (B>) 
Machine: BAOO 3100 3400 


B, (3) and B2(3): 1234 5678 0000 


Storage—Before 


1234 5678 0100 
1234 5678 0400 





Storage—After 


1234 5678 0100 
1234 5678 0400 
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MOVE NUMERIC TO ZONE (MVNZ) 
Instruction Description 


The numeric half of the second operand is placed in the 
zone half of the first operand. 


Format: SS 
Lee | lojs| o, [s] _o, _ 
O Bits 12 16 20 32 36 47 


Operation: The numeric half of the byte is the rightmost 
4 bits, and the zone half byte is the leftmost 4 bits. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


MVNZ Example 


Op D, 
BB 400 


0 Bits 12 16 20 32 36 47 


Assembler: MVNZ D,(B,), D2 (B,) 
Machine: BBOO 3100 3400 


B, (3) and B2 (3): 1234 5678 0000 


Storage — Before 


1234 5678 0100 
1234 5678 0400 





Storage — After 


1234 5678 0100 
1234 5678 0400 
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MOVE PACKED SHIFTED (MVPS) 
Instruction Description 


The second operand is shifted as specified by the 
contents of byte register hex F and is placed in the 
first-operand location. 


Format: SS 


(re iululel o [el 
8 12 


0 Bits 16 20 32 36 47 


Operation: The result is padded on the right or left with 
zeros, aS required, and the sign is right-adjusted. The 
second operand is unchanged by the operation except 
when the operands overlap. The contents of byte 
register hex F are unchanged by the operation. 


Bits 2-7 of byte register hex F indicate the direction of 
the shift and the number of digit positions to be shifted. 
The remaining bits in the register are ignored. When bit 
2 of byte register hex F is zero, a left shift is specified, 
and when bit 2 is 1, a right shift is specified. Bits 3-7 
of byte register hex F are treated as a true binary 
number specifying the number of digit positions to be 
shifted (ranging in value from zero to 31). 


The operation is performed as if the entire second 


operand was shifted prior to modifying any byte of the 
first operand. 
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The second operand is treated as a packed decimal 
format field and is checked for a valid digit code. An 
improper code causes a data exception and the 
operation is terminated with the first operand 
unchanged. Only the digits of the second operand are 
shifted; its sign is right-aligned in the first-operand field 
and, if necessary, changed to the preferred sign code. 
Zeros are supplied to the digits of the first operand that 
do not receive a digit from the second operand. 


During right shifts, the digits shifted out of the rightmost 
digit position are ignored and lost. For a left shift, all 
significant digits shifted are placed in the first-operand 
field except when the first-operand field is too short to 
include all shifted significant digits. Then the rightmost 
digits of the shifted second operand are placed in the 
first-operand location and a decimal overflow occurs. 


Overflow: See Operation. 


Sign Code: The second operand is checked for a valid 
sign code. An improper code causes a data exception 
and the operation is terminated with the first operand 
unchanged. 


In the absence of a decimal overflow, the sign of a zero 
result is made positive. With a decimal overflow, the 
sign of a zero result is the same as the original sign, but 
the code is the preferred sign code. 


See Operation for further information. 


J 


Condition Code: 


0 Result = O 
1 Result < O 
2 Result > O 
3 —_ 


A shift of zero can be used to set the condition code 
based on the value of the field. 


Carry: Not applicable. 


Boundary Requirements: The first and second operands 
can overlap. All combinations of overlap and shift are 
allowed. No data alignment is required for either 
operand. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Decimal overflow 
Effective address overflow 


MVPS Example 


Op |L, D, 

FB F CBO 
O Bits 8 12 16 20 32 36 47 
Assembler: MVPS D,(L,,B,), D2(L2, Bz) 
Machine: FBFF 3CBO 4FO00 
B, (3): 0000 0A10 0000 
B,(4): 0000 1B20 0000 


r(F): 08 


Storage — Before 


0000 0A10 OCBO 


0000 1B20 OFOO 





Storage — After 


0000 0A10 OCBO 


0000 1B20 OFOO 





Before After 


Condition Code: x 2 
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MOVE PACKED SHIFTED ZERO (MVPS2Z) 


Instruction Description 


Byte register hex F is first set to zero and then the 
second operand is shifted as specified by the contents 
of byte register hex F and is placed in the first-operand 
location. 


Format: SS 


wiufel oo je) 
8 


0 Bits 12 16 20 32 36 47 


Operation: The result is padded on the right or left with 
zeros, aS required and the sign is right-adjusted. The 
second operand is unchanged by the operation except 
when the operands overlap. The contents of byte 
register hex F are set to zero before starting the 
operation. 


Bits 2 through 7 of byte register hex F indicate the 
direction of the shift and the number of digit positions 
to be shifted. The remaining bits in the register are 
ignored. When bit 2 of byte register hex F is zero, a left 
shift is specified, and when bit 2 is 1, a right shift is 
specified. Bits 3 through 7 of byte register hex F are 
treated as a true binary number specifying the number 
of digit positions to be shifted (ranging in value from 
zero to 31). 


The operation is performed as if the entire second 
operand was shifted prior to modifying any byte of the 
first operand. 


The second operand is treated as a packed decimal 
format field and is checked for a valid digit code. An 
improper code causes a data exception and the 
operation is terminated with the first operand 
unchanged. Only the digits of the second operand are 
shifted; its sign is right-aligned in the first operand field 
and, if necessary, changed to the preferred sign code. 
Zeros are supplied to the digits of the first operand that 
do not receive a digit from the second operand. 
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During right shifts, the digits shifted out of the rightmost 

digit position are ignored and lost. For a left shift, all J 
significant digits shifted are placed in the first-operand 

field except when the first-operand field is too short to 

include all shifted significant digits. Then the rightmost 

digits of the shifted second operand are placed in the 

first-operand location and a decimal overflow occurs. 


Overflow: See Operation. 


Sign Code: The second operand is checked for a valid 
sign code. An improper code causes a data exception 
and the operation is terminated with the first operand 
unchanged. 


In the absence of a decimal overflow, the sign of a zero 
result is made positive. With a decimal overflow, the 
sign of a zero result is the same as the original sign, but 
the code is the preferred sign code. 


See Operation for further information. 


Condition Code: 


O Result 
1 Result 
2 Result 
2 aie 


u 


VA 


A shift of zero can be used to set the condition code 
based on the value of the field. 


Carry: Not applicable. 


Boundary Requirements: The first and second operands 
can overlap. All combinations of overlap and shift are 
allowed. No data alignment is required for either 
operand. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Decimal overflow 
Effective address overflow 





MVPSZ Example 


Op |L,|L, |B, D, D, 
FC | FI F|3 CBO FOO 
8 12 


0 Bits 16 20 32 36 47 





Assembler: MVPSZ D, (L,, B,), Dz (L,,B,) 
Machine: FCFF 3CBO 4F00 
B,(3): 0000 0A10 0000 
B2 (4): 0000 1B20 0000 
Before After 


r(F): 08 00 


Storage — Before 


0000 0A10 OCBO 


0000 1B20 OFOO 





Storage — After 


0000 0A10 OCBO 


0000 1B20 OFOO 





Before After 


Condition Code: x 2 


Instruction Descriptions 
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MOVE ZONE TO NUMERIC (MVZN) 
Instruction Description 


The zone half of the second operand is placed in the 
numeric half of the first operand. 


Format: SS 
jec| [ojs| o, Jel o, 
O Bits 12 16 20 32 36 47 


Operation: The zone half of the byte is the leftmost 4 
bits, and the numeric half of the byte is the rightmost 4 
bits. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


MVZN Example 

Op D, 

BC 9A0 
0 Bits 12 16 20 32 36 47 
Assembler: MVZN D,(B,), D, (B2) 


Machine: BCOO 3560 39A0 


B, (3) and B, (3): OODC ODB1 0000 


Storage — Before 


OODC ODB1 0560 
O0ODC ODB1 O9A0 





Storage — After 


OODC ODB1 0560 
OODC ODB1 O9A0 





MOVE ZONE TO ZONE (MVZZ) 
Instruction Description 


The zone half of the second operand is placed in the 
zone half of the first operand. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The zone half of the byte is the leftmost 4 
bits. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


MV2ZZ Example 


Op D, 
BD 9A0 


O Bits 12 16 20 32 36 47 


Assembler: MVZZ D, (B,), D,(B>) 
Machine: BDOO 3560 39A0 


B, (3) and B, (3): OODC ODB1 0000 


Storage — Before 


OODC ODB1 0560 
OODC ODB1 O9A0 





Storage — After 


OODC ODB1 0560 
OODC ODB1 O9A0 
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MULTIPLY HALFWORD STORAGE (MHS) 
Instruction Description 
The product of the multiplier (the second operand) and 


the multiplicand (the first operand) replaces the 
multiplicand. 


Format: SS 
joc] lo|s| o [el o 
O Bits 16 20 32 36 47 


Operation: Both multiplier and multiplicand are 16-bit 
signed binary integers. The product is always a 32-bit 
signed binary integer and occupies a word of storage at 
the first-operand location. The multiplicand is taken 
from the second haifword of the first operand. The 
contents of the first halfword are ignored unless it 
contains the multiplier. 


Overflow: An overflow cannot occur. 


Sign Code: The sign of the product is determined (by 
the rules of algebra) from the multiplier and multiplicand 
signs. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first operand must start on 
a word boundary; the halfword storage operand must 
start on a halfword boundary; and the word storage 
operand must start on a word boundary. Otherwise a 
specification exception occurs, and the operation is 
suppressed. 
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Program Exceptions: 


Address translation 


— Addressing 
— Effective address overflow 
— Specification 
MHS Example 
Op 
DC 
O Bits 16 20 32 36 47 


Assembler: MHS D, (B;), D2 (B2) 
Machine: DCOO 3150 3160 


B, (3) and B2(3): 1A45 BC3D 0000 


Storage — Before 


0/8 2/A 
1A45 BC3D 0150| O000 £-FFF4 
1A45 BC3D 0160] 9002 





Storage — After 


0/8 2/A 
1A45 BC3D 0150] FFFF FFE8 
1A45 BC3D 0160} 0002 





MULTIPLY LONG FLOAT (MLF) 


Instruction Description 


The second operand is multiplied by the first operand 
(two-operand format) or the third is multiplied by the 
second operand (three-operand format), and the product 
is placed in the first operand location. 


Format: SS 


is|e{ oo |e] p, 
8 12 


0 Bits 16 20 32 36 47 


Operation: A two-operand or three-operand format can 
be specified. A two-operand format is used if base 
register O is specified for the third operand. A 
three-operand format is used if one of the base 
registers hex 1 through F is specified for the third 
operand. Interchanging the two source operands does 
not affect the value of the product. However, the first 
operand data is overwritten by the result. 


Multiplication of two floating-point numbers uses 
exponent addition and significand multiplication. The 
sum of the signed (unbiased) exponents of the source 
operands is used as the exponent of the intermediate 
product. This applies for denormalized and normalized 
numbers. 


The multiplication of the significands is performed as if 
to infinite precision to form the intermediate product 
significand. This product is normalized, if necessary, 
before rounding. The rounding is performed according 
to the mode speciified in the task dispatching element. 


When either operand is O, the product is made O, and 
no exceptions occur. 


lf a masked non-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
product. The source operands are checked for this value 
in the order of their specification with the masked 
not-a-number with the larger fraction value being 
provided as the product. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the product is determined by the 
rules of algebra. This is the exclusive OR of the signs of 
the source operands. This applies to the products of 0, 
infinity, and normal finite numbers. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: All operands must be fullword 
aligned, otherwise, a specification exception occurs, and 
the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 
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Programming Note: The following is a summary of the 
products for various combinations of operands. 


pede First Source (Multiplicand) | Second Source (Multiplier) 
+Real number # 0 : 
+0 


+ 








0 

0 

-Real number # 0 -0 

Ee 

+Real number # 0 

soo Real number #0 
-0 


+Real number # O 


ee 
Oo 


-0 























-Real number # O 


+Real number # O 


+ 
© 


-Real number # O 


+0 (see note) +Small real number # O +Small real number # O 


+0 (see note) -Small real number # O -Small real number # O 





-O (see note) +Small real number # O 


-Small real number # O 


-0 (see note) -Small real number # O +Small real number # O 


Invalid operand exception +\nfinity +0 
Invalid operand exception +|nfinity -0 
Invalid operand exception - Infinity +0 
Invalid operand exception - Infinity -O 
+Infinity +Infinity +Real number # O 
+Infinity - Infinity -Real number # O 
+Infinity +Real number # O +|nfinity 
+Infinity -Real number # O - Infinity 


+Infinity +Infinity +I|nfinity 


+Infinity - Infinity -Infinity 


-Infinity -Infinity +Real number # O 


-Infinity +Infinity -Real number # O 


-Infinity -Real number # O 
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' proce First Source (Multiplicand) | Second Source (Multiplier) 
piednemoe 80 


- Infinity infinity Mihiv: --.  .. .... | 


- Infinity - Infinity +Infinity 


Masked not-a-number Masked not-a-number Not not-a-number 
Masked not-a-number Not not-a-number Masked not-a-number 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operand exception _|Unmasked not-a-number 
Invalid operand exception Unmasked not-a-number 


Legend: 
Not not-a-number = Anything but a not-a-number. 
Any = Any floating-point field value. 


Note: For two small valued real numbers that are not equal to O, a floating-point underflow that has a zero product 
rather than a denormalized product can occur. 
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MLF Example 


Op D, 
CE 060 
O Bits 8 12 16 20 32 36 47 

Assembler: MLF D,(B,), D,(B,), B3 

Machine: CE33 4050 4060 

B3(3): 0010 0200 0070 


B, (4) and B, (4): 0010 0200 O000 


Storage — Before 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Storage — After 


0/8 2/A 
0010 0200 0050 D110 0460 » 


0010 0200 0060 C080 0230 
0010 0200 0070 5080 0230 





Condition Code: Not changed. 
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MULTIPLY PACKED (MP) 


Instruction Description 


The product of the multiplier (the second operand) and 
multiplicand (the first operand) replaces the multiplicand. 


Format: SS 


3 iutude| oo jel oo 


0 Bits 8 12 16 20 32 36 47 


Operation: The multiplier size is limited to 15 digits and 
sign and must be less than the multiplicand size. A 
length code (L,) larger than seven or larger than or equal 
to the length code L, causes a specification exception. 


The multiplicand must have at least as many bytes of 
left zeros as the multiplier field size, in bytes; otherwise 
a data exception occurs and the operation is terminated. 
The maximum product size is 31 digits. At least one 
leftmost digit of the product field is zero. 


All operands and results are treated as signed integers, 
right-aligned in their field. 


Digit codes are checked for validity; invalid codes cause 
a data exception, and the operation is terminated. 


Overflow: The definition of the multiplicand field ensures 
that no product overflow can occur. 


Sign Code: The sign of the product (the product is 
assigned a preferred sign) is determined by the rules of 
algebra from the multiplier and multiplicand signs, 
except that a zero result is always positive. The sign is 
encoded as 1111 (hex F) for a positive result and 1101 
(hex D) for a negative result. The sign codes are 
checked for validity; an invalid code causes a data 
exception, and the operation is terminated. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The multiplier and product 
fields can overlap only if their rightmost bytes coincide. 
Improperly overlapping fields cause a data exception, 
and the operation is terminated. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

— Effective address overflow 
Specification 


MP Example 
L, L, B. 
5| 3 7 
O Bits 8 12 16 20 32 36 47 
Assembler: MP D,(L,,B,), Dz2(b2, Ba) 
Machine: F353 6120 7240 


B, (6): 0A38 2310 0000 


B.(7): OA38 6405 0000 


Storage — Before 


0A38 2310 0120 
0A38 6405 0240 





Storage — After 


0/8 2/A 
0A38 2310 0120 0000 0841 
0A38 6405 0240 0000 004D 
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Instruction Descriptions 





MULTIPLY PACKED LONG (MPL) 
Instruction Description 


The product of the multiplier (the second operand) and 
the multiplicand (the first operand) replaces the 
multiplicand. 


Format: SS 


ntute| 0, fe) 
8 


0 Bits 12 16 20 32 36 47 


Note: The Multiply Packed Long instruction is 
implemented in vertical microcode (VMC) and is treated 
as an implicit SVL by the IMP processor. The operation 
code is used as the index into the SVL table, as 
described in the section on SVLs in Chapter 6. 


Operation: The product is placed into the first-operand 
field and can contain a maximum of 63 digits and sign 
(L,+L,+2=32 bytes). The multiplicand occupies the 
leftmost L,+1 bytes of the first operand. The remaining 
L,+1 bytes of the first operand are not used as 
multiplicand data. At least one leftmost digit of the 
product field is zero. 


All operands and results are treated as signed integers, 
right-aligned in their fields. Digit codes are checked for 
validity; an invalid code causes a data exception, and 
the operation is terminated. 


Overflow: The definition of the multiplicand field ensures 
that no product overflow can occur. 


Sign Code: The sign of the product (the product is 
assigned a preferred sign) is determined by the rules of 
algebra from the multiplier and multiplicand signs, 
except that a zero result is always positive. A positive 
sign is encoded as 1111 (hex F); a negative sign is 
encoded as 1101 (hex D). 


The sign codes are checked for validity; an invalid code 


causes a data exception, and the operation is 
terminated. 
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Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The multiplier and product 
fields may overlap if their rightmost bytes coincide. 
Improperly overlapping fields causes a data exception, 
and the operation is terminated. 


Program Exceptions: 


Address translation 
Addressing 

Data 

Effective address overflow 


Notes: 

1. L, specifies 1 less than the number of bytes by which 
the length of the first operand exceeds the length of 
the second operand. 

2. L, specifies 1 less than the length in bytes of the 
multiplier. The multiplier can contain a maximum of 
31 digits and sign. 





MPL’ Example 





O Bits 8 16 20 32 36 


Assembler: MPL D,(L;, B;), Dz(L2, Bz) 
Machine: F931 3550 4A10 

B, (3): 0000 ABCD 0000 

B,(4): 0000 BCDE 0000 


Storage — Before 
0/8 2/A 


0000 ABCD 0550 | 1234 567F 
0000 BCDE 0A10} 123F 





Storage — After 


0/8 2/A 
0000 ABCD 0550 | 0015 ~~ 1851 
0000 BCDE OA10|] 123F 
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MULTIPLY SHORT FLOAT (MSF) 


instruction Description 


The second operand is multiplied by the first operand 
(two-operand format) or the third is multiplied by the 
second operand (three-operand format), and the product 
is placed in the first operand location. 


Format: SS 


‘3ie{ oo jel o 


O Bit 8 12 16 20 32 36 47 


Operation: A two-operand or three-operand format can 
be specified. A two-operand format is used if base 
register O is specified for the third operand. A 
three-operand format is used if one of the base 
registers hex 1 through hex F is specified for the third 
operand. Interchanging the two source operands does 
not affect the value of the product. However, the first 
operand data is overwritten by the result. 


Multiplication of two floating-point numbers uses 
exponent addition and significand multiplication. The 
sum of the signed (unbiased) exponents of the source 
operands is used as the exponent of the intermediate 
product. This applies for denormalized and normalized 
numbers. 


The multiplication of the significands is performed as if 
to infinite precision to form the intermediate product 
significand. This product is normalized, if necessary, 
before rounding. The rounding is performed according 
to the mode specified in the task dispatching element. 


When either operand is O, the product is made O, and 
no exceptions occur. 


lf a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
product. The source operands are checked for this value 
in the order of their specification with the masked 
not-a-number with the larger fraction value being 
provided as the product. 
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Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to J 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the product is determined by the 
rules of algebra. This is the exclusive OR of the signs of 
the source operands. This applies to the products of 0, 
infinity, and normal finite numbers. 


Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: All operands must be fullword _ 
aligned, otherwise, a specification occurs, and the 
operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 


Programming Note: The following is a summary of the 
products for various combinations of operands. 


‘cout |. First Source (Multiplicand) |Second Source (Multiplier) 
satura 


+0 +0 +0 

“Real number # 0 oo 
+0 oo 
+Real number # 0 

0 | Real number # 0 

+Real number # 0 oo 
+0 oo 
-0 

+0 






Oo |O 


woo 
+0 
0 tReet number #0 
vo Real number 
+0 (see note) 
+0 (see note} 
-0 (see note 
-0 (see note! 
Invalid operand exception 
Invalid operand exception |tinfinity =O 
Invalid operand exception 
-infinity fo 
+ininity 


-Real number # O 












Invalid operand exception 


+nfinit 
+nfinity 
+nfinity 
“Infinity 
“Infinity 


Note: For two small values of real numbers that are not equal to 0, a floating-point 
underflow which has a zero product rather than a denormalized product can occur. 


+Hnfinity -Real number # 0 
+infinity +Real number # 0 
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predict First Source (Multiplicand) | Second Source (Multiplier) 
esis 


- Infinity +Real number # 0 anit 






-Infinity 





-Infinity +\nfinity 










+nfinity 


Masked not-a-number Masked not-a-number 
Masked not-a-number Masked not-a-number 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operand exception Unmasked not-a-number 
Invalid operand exception Unmasked not-a-number 


Legend: 
Not not-a-number = Anything but not-a-number 

















Any = Any floating-point field value 


MSF Example 

Op D, 

AE O60 
O Bits 12 16 20 32 36 47 
Assembler: MSF D, (B,), D2 (B,), Bs Storage — Before 
Machine: AE33 4050 4060 2/A 

0010 0200 0050 XXXX 

B3(3): 0010 0200 0070 0010 0200 0060 0000 
B, (4) and B, (4): 0010 0200 0000 0010 0200 0070 0000 


Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 


Condition Code: Not changed. 
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MULTIPLY WORD STORAGE (MWS) 
Instruction Description 
The product of the multiplier (the second operand) and 


the multiplicand (the first operand) replaces the 
multiplicand. 


Format: SS 
Lec | [o|s| o, |e| o, _ 
O Bits 12 16 20 32 36 47 


Operation: Both multiplier and multiplicand are 32-bit 
signed binary integers. The product is always a 64-bit 
signed binary integer and occupies 8 bytes of storage at 
the first-operand location. The mulitiplicand is taken 
from the second word of the first operand. The 
contents of the first word are ignored unless it contains 
the multiplier. 


Overflow: An overflow cannot occur. 


Sign Code: The sign of the product is determined by the 
rules of algebra from the multiplier and multiplicand 
signs. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Both operands must start on a 
word boundary; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

— Data 

Effective address overflow 


MWS Example 
Op D. 
EC AOO 
0 Bits 12 16 20 32 36 47 


Assembler: MWS D, (B,), D2 (B2) 
Machine: ECOO 3100 3A00 


B, (3) and Bz (3): 0000 1234 0000 


Storage — Before 


0/8 2/A 4/C 6/E 


0000 1234 0100 0000 0000 0000 ~ 1F40 
(8000) 
FFE4  (-28) 


0000 1234 OAO0O FFFF 





Storage — After 


0/8 2/A 4/C 6/E 


0000 1234 0100 FFFF FFFF FFFC- 9500 


(-224 000) 
FFE4 (-28) 


0000 1234 OAO00 FFFF 
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OR BYTE (OB) 
Instruction Description 
The inclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RS 


(72 tnlole| o 
8 12 


0 Bits 16 20 31 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result 
Result # 


i] 
Oo Oo 


WN Oo 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 
) 


— Address translation 
— Addressing 
— Effective address overflow 


OB Example 


Op D, 
79 1A0 
12 31 


O Bits 8 16 20 


Assembler: OB r,, D2 (B>) 
Machine: 7950 31A0 


B2(3): 0001 O0A01 0000 


Storage — Before and After 


0001 0A01 01A0 





Before After 
ry (5): AA FF 
Condition Code: x 1 


OR BYTE IMMEDIATE (OBI) 
Instruction Description 


The inclusive OR of the first and second operands is 
placed in the first-operand location. 


Format: Sl 
O Bits 8 16 20 31 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = O 
1 Result # 0 
2 Be 
3 ae 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


OBI Example 
Op I, D, 
99 A5 1A0 
0 Bits 8 16 20 31 


Assembler: D,(B,), I2 
Machine: 99A5 31A0 


B,(3): 0A10 BOC5 Q000 


Storage — Before 


0A10 BOC5 01A0 





Storage — After 


0A10 BOCS 01A0 





Before After 


Condition Code: x 1 
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OR BYTE REGISTER (OBR) 
Instruction Description 
The inclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 
Result # 


WON — Oo 
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Carry: Not applicable. ) 


Boundary Requirements and Program Exceptions: None. 


OBR Example 


O Bits 8 12 15 
Assembler: OBR r,, rz 


Machine: 1934 


Before After 


r1 (3): 59 FD 
ry (4): A4 A4 
Condition Code: x 1 


OR BYTE REGISTER IMMEDIATE (OBRI) 
Instruction Description 
The inclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RI 


O Bit 8 12 16 24 31 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Codes: Not applicable. 


Condition Code: 
0 Result = O 
1 Result # O 
2 Boia 
3 ae 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


OBRI Example 


Op 
49 


QO Bits 8 12 16 24 31 


Assembler: r,, I, 
Machine: 4930 3300 

Before After 
ry (3): 55 77 


Condition Code: x 1 
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OR CHARACTERS (OC) 
Instruction Description 


The inclusive OR of the first and second operands is 
placed in the first-operand location. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Each operand field is processed left to right. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Result = 
Result # 


WN — Oo 


Carry: Not applicable. 


Boundary Requirements: The operands can overlap if the 
leftmost byte of the first operand is coincident with or 
to the left of the leftmost byte of the second operand; 
otherwise the overlap is destructive and the results are 
unpredictable. Neither operand may cross a segment 
boundary; otherwise an effective address overflow 
occurs and the operation is suppressed. 
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Program Exceptions: ) | 


— Address translation 
— Addressing 
— Effective address overflow 


OC Example 
Op D, 
c9 = A50 
O Bits 16 20 32 36 47 


Assembler: OC D,(L,, B;), D2 (Bz) 
Machine: C903 32CO 3A50 


B, (3) and B2 (3): 001A 5C9E 0000 


Storage — Before 


0/8 2/A 4/c 6/E 
001A 5C9E 02C0 1234 5678 
001A 5C9E OA50 | 5678 9YQ9ABC 





Storage — After 


0/8 2/A 4/C 6/E 
001A 5C9E 02CO | 567C DEFC 
001A 5C9E OA5O | 5678 YQ9ABC 





Before After 


Condition Code: x 1 





OR HALFWORD (OH) 
Instruction Example 
The inclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RS 


O Bits 8 12 16 20 31 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Oo oO 


Result 
Result + 


ON — © 


Carry: Not applicable. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


OH Example 


Address translation 
Addressing 
Effective address overflow 
Specification 


Op D, 
80 000 
31 


O Bits 8 12 


16 20 


Assembler: OH R,, D2 (B2) 


Machine: 8033 4000 


B,(4): OAB1 OOOA 1000 


OAB1 OOOA 1000 


R, (3): 


Condition Code: 


Storage — Before and After 


Before After 


5A5A 


FFFF 


Instruction Descriptions 





10-303 


OR HALFWORD REGISTER (OHR) 
Instruction Description 
The inclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RR 


QO Bits 8 12 15 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = 0 
1 Result # 0 
2 = 
3 = 
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Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


OHR Example 


QO Bits 8 12 15 
Assembler: OHR R;,, R2 
Machine: 2934 


Before After 


R,(3): 1234 567C 
R» (4): 5678 5678 
Condition Code: x 1 





OR HALFWORD REGISTER IMMEDIATE (OHRI) 
Instruction Description 
The exclusive OR of the first and second operands is 


placed in the first-operand register. 


Format: RI 


O Bit 8 12 16 31 


Operation: Operands are treated as logical quantities, 
and the inclusive OR is applied bit by bit. A bit position 
in the result is set if the corresponding bit position in 
one or both operands is set; otherwise the result bit is 
reset. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Result = O 
1 Result # 0 
2 2s 
3 = 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


OHRI Example 


I, 
1357 
16 31 


O Bits 8 12 
Assembler: OHRI R;, Iz 
Machine: 5930 1357 

Before After 
Ri: 2468 377F 


Condition Code: x 1 
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PERFORM PAGING REQUEST (PPR) 


Instruction Description 


Format: SS 


jes | 4 [el oo |e) o 
8 


0 Bits 16 20 32 36 47 


Note: The Perform Paging Request instruction is 
implemented in vertical microcode (VMC) and is treated 
as an implicit SVL by the IMP processor. The operation 
code is used as an index into the SVL table, as 
described in the section on SVLs in Chapter 6. 


Operation: The operation specified by the third operand 
is performed on all pages within a contiguous range of 
virtual storage addresses. 


lf the high-order bit of |, is zero, the first operand 
occupies 6 bytes in storage and contains the beginning 
address of the range of virtual addresses. The second 
operand occupies 6 bytes in storage and contains the 
last address of the range of virtual addresses. 


If the high-order bit of I, is 1, the first and second 
operand occupy 6 bytes of storage and point to the 
beginning of the access group table of contents. 


The operation specified by the third operand, |,, is 
performed only in page size increments. Bits 0-38 of 
both the first and second operands identify the first and 
last pages in the range of pages that participate in the 
operation. Bits 39-47 of both operands are not used. 


Byte register hex F, which is used as an operand for 
bring and clear requests, holds either the storage pool 
ID or zero. If not zero, the storage pool indicated is 
used to allocate page frames to satisfy the request. If 
zero, the storage pool in the TDE (task dispatching 
element) is used to allocate page frames. If the storage 
pool cannot satisfy a request that specifies an increment 
pin count (no unpinned pages available), an invalid pool 
state exception occurs and the operation is suppressed. 
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A specification exception occurs and the operation is 
suppressed for any of the following conditions: 





2 


¢ The first and-second operand addresses are not 
within the same segment or segment group. 


« The second-operand address is less than the 
first-operand address. 


« Either the first or second-operand address is a V=R 
(virtual equals real) address. 


e The third-operand is invalid. 


If asynchronous request and increment/decrement pin 
count are both specified on a bring, purge, or write, a 
specification exception occurs. 


If the segment or segment group specified by the 

contents of the first operand does not exist, an invalid 

segment exception occurs and the operation is 

suppressed. If the page specified by the contents of the 

second operand does not exist, an invalid page 

exception occurs and the operation is suppressed. If a 

permanent |/O error occurs while trying to read a page 

from auxiliary storage, a page read error exception 

occurs and the operation is completed abnormally. , 
These last three exceptions can occur for synchronous J 
requests only. If a write to auxiliary storage of a pinned 

page is attempted, an invalid write request occurs and 

the operation is completed abnormally. 


If bring or purge access group is indicated by I,, invalid 
page, invalid segment, or permanent |/O error 
exceptions are signaled if the access group table of 
contents indicated by the first and second operands is 
smaller than expected, is nonexistent, or has an |/O 
error, respectively. 





( The third operand is interpreted as follows: 


Bits |code Operation/Description 


O Any function described in bits 3-5 may be performed on an access group. 
1 Perform the function described in bits 3-5 on an access group. Only bring and 
purge are valid and bits 6 and 7 must be zero. 


2 [+ | Reserved: must be zero 
3-6 [000 | Used during page faults 
oo1 sd Bring: copy the specified page(s) from auxiliary to main storage. 


Clear: provide zeroed main storage frames for the specified page(s) occurs and the 
prior contents are lost. 
Plt Write: copy the specified page(s), if changed, from main storage to auxiliary storage. 


Purge: copy the specified page(s), if changed, from main storage to auxiliary storage. 
|In addition, make all the frames associated with the pages available for reassignment. 


Remove: remove the specified page(s) from main storage. Do not copy changed 
pages back to auxiliary storage. Make the main storage frames immediately available 
for reassignment; the page(s) are no longer addressable in main storage. The 
contents of the pages are set to an undefined state by the remove. 


For Bring, Write, and Purge: 
| O Synchronous request (wait). 
1 Asynchronous request (do not wait). 
For Clear and Remove: 
O Must be zero (always synchronous). 


For Bring and Clear: 
OQ Leave pin count unchanged. 
1 Increment pin count by 1. 
For Write, Purge, and Remove: 
O Leave pin count unchanged. 
1 Decrement pin count by 1. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first and second 
operands must both begin on a word boundary; 
otherwise a specification exception is recognized and 
the operation is suppressed. 


Program Exceptions: 


— Effective address overflow 

— Invalid page (synchronous requests only) 

— Invalid pin request (synchronous requests only) 

— Invalid pool state (synchronous requests only) 

— Invalid segment (synchronous requests only) 

— Invalid write request (synchronous requests 
only) 

— Page read error (synchronous requests only) 

— Specification 
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PPR Example 
) 
Op D, D, 
E8 600 OFF 
O Bits 8 16 20 32 36 47 
Assembler: PPR D,(B,), Dz (Bz), I3 


Machine: E808 3600 39FF 


B,(3) and B, (3): 6DO0 ACOO 0000 


Storage — Before and After 


0/8 2/A 4/C 6/E 
6D00 ACOO 0600 XXXX XXXX XXXX XXXX 


O9F8 XXXX XXXX XXXX XXXX 
0600 through O9FF = xxxx 





Storage — Before and After 


0/8 2/A 4/C 6/E 
6D00 ACOO 0600 0000 0000 0000 £0000 ) ) 


O9F8 0000 0000 0000 #£«0000 
0600 through O9FF = 0000 








This page is intentionally left blank. 
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READ REFERENCE AND CHANGE AND RESET 
REFERENCE (RRCRR) 


Instruction Description 


The RRCRR instruction aids the page replacement 
process. A reference bit is set by the hardware each 
time a page is referenced. The bit is periodically 
examined and reset by the page replacement process. 
The page replacement process is informed in this way 
whether the page was referenced since it was last 
examined. A second hardware bit called the change bit 
is set whenever an instruction alters the contents of a 
page. This enables the page replacement process to 
know whether or not to page out the page he wishes to 
steal before destroying the addressability. 


The RRCRR instruction takes care of these functions as 
well as accounting for the fact that the current state of 
the change flag may be in the internal hardware LB 
(lookaside buffer), rather than the PD (primary directory) 
entry itself. 


Format: Sl 
O Bit 8 12 16 20 31 


Operation: The reference and change bits of a PD entry 
are read, and the result determines the setting of the 
condition code. If a copy of the PD entry resides in the 
LB, that copy’s change bit is ORed into bit 42 of the 
actual PD entry. The copy is then removed from the LB. 
Subsequently, the reference bit is reset in the PD entry. 


The operand for this instruction is a primary directory 
index value. This index, when multiplied by 16 (ignoring 
any bits carried out of the halfword) and added to the 
base address of the primary directory, addresses the PD 
entry to be examined. 
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The primary directory entry is identified by the first 
operand. Bits 0-15 of this halfword storage operand are 
used as the primary directory entry index value. If the 
index value specifies a directory entry that contains V=R 
addresses, a specification exception occurs and the 
operation is suppressed. The high-order 4 bits (bits 
0-3) of the PD index value are ignored and treated as 
zeros. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
0 Reference bit zero, change bit zero 
1 Reference bit zero, change bit one 
2 Reference bit one, change bit zero 
3 Reference bit one, change bit one 


Carry: Not applicable. 


Boundary Requirements: The first operand occupies 2 
bytes in storage and must begin on a halfword 
boundary; otherwise a specification exception occurs 
and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


J 


C 


RRCRR Example 

Op E, |B, D, 

83 0} 1 330 
QO Bit 8 12 16 20 31 
Assembler: RRCRR D, (B,) 
Machine: 8300 1330 

Before After 

B, (1): 0000 0407 8300 0000 0407 8300 
Condition Code: x 3 
PD (primary directory) base address 0000 0101 0000 
The halfword at the first-operand effective address 
identifies a PD entry index. The processor converts the 
PD index (hex OOD3) to a PD offset by multiplying the 
index by 16. 
The PD entry address is the sum of the generated offset 


(hex D300) and the PD base address, which is implicitly 
supplied by the machine. 


Storage — Before and After 


0000 0407 8630 





The first 5 bytes of the PD entry [JJ (base register 
contents plus displacement) are verified to be virtual = 
virtual. 


Primary Directory 


Segment Identifier Status Index Reserved|EOC PINCNT Reserved 
0 Bits 31 40 47 | 48 59| 6062 | 63 | 64 71 | 72 120 


D300 | 0000 0000 0000 0000 0000 0101 0000 0101 | 0101 1100 | 1100 0000 | 1000 0100 0000 0000 0000 
aS LE bara 


The values of the reference and change bits in the LB 

(lookaside buffer) are inclusively ORed into the PD entry 
Fi. The values are used to set the condition code. The 
reference bits in both the LB and the PD entry are reset. 


0000 0101 0000 
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RECEIVE COUNT (RECC) 
Instruction Description 


The current value of the counter designated by the 
operand is decremented by the limit value in the SRC 
(send/receive counter) when the current value of the 
counter is equal to or greater than the limit value of the 
counter. 


Format: Sl 


_o7 {| [oj & | a 
8 12 


O Bits 16 24 31 


Operation: Normal instruction sequencing proceeds with 
the updated instruction address. 


If the current value of the counter is less than the limit 
value of the counter, the instruction is nullified, and the 
TDE (task dispatching element) of the task issuing the 
instruction is dequeued from the TDQ (task dispatching 
queue) and is enqueued onto the SRC wait queue in the 
TDE priority sequence. Bytes hex 16 through 1B of the 
TDE are updated accordingly. The task dispatcher is 
invoked; the task issuing the instruction is put into the 
wait state and another task is dispatched. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Invalid descriptor 
Specification 


RECC Example 


Op B, D, 
67 4 000 


O Bits 8 12 16 20 31 


Assembler: RECC D, (B;) 
Machine: 6700 4000 


B, (4): 012A 3C2B 1000 





First TDE Address 


1666 76A0 0000 


Next TDE Address 


1234 0000 0000 





Before 
TDQ 
Descriptor 
0 Bytes 
Current TDE 
1666 76A0 0000 Descriptor 
0 Bytes 
SRC 


012A 3C2B 1000 Descriptor 





By tes 


The current TDE is dequeued from the TDQ and enqueued to the SRC. 
The task issuing the RECC instruction is put in the wait state. 
The task associated with the highest priority TDE on the TDOQ is dispatched. 


First TDE Address 
ABCD 0000 0000 


Instruction Descriptions 
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After 


TDQ 


First TDE Address 


Descriptor 1234 0000 0000 








‘@) Bytes 2 8 
TDE 
; Next TDE Address 
1 De t 
666 76A0 0000 apter ABCD 0000 0000 
0 By tes 2 7 


SRC 


First TDE Address 


01 2A 3C2B 1000 Descriptor 1666 76A0 0000 









TDQ 
Byte 0, Bit 3 Before 
| One or More = 1 — or More = 1 


TDE 
Byte 0, Bit 4 Before After 
Last TDE=0 
| Not Last TDE= 1 Last TDE = 1 
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RECEIVE MESSAGE (RECM) 
Instruction Description 


An SRM (send/receive message) is dequeued from the 
message list of the SRO (send/receive queue) 
designated by the second operand, or the task is put 
into a wait state. The address of the SRM dequeued is 
loaded into B,. 


Format: SS 


8 12 


0 Bits 16 20 32 36 47 


Operation: The search type is specified by the I-field. If 
no message satisfies the search type, or if the message 
list is empty, B, is not altered. The messages searched 
are accessed sequentially, starting with the first 
message. The first message satisfying the search type 
is dequeued. The key is treated as unsigned binary data. 


If no message satisfies the search type, or if the 
message list is empty, the instruction is nullified. The 
current TDE (task dispatching element) is dequeued from 
the TDQ (task dispatching queue) and is enqueued to 
the SRQ wait list in key (priority) sequence, bytes hex 
16-1B of the TDE are updated accordingly, and the task 
dispatcher is invoked. 


I-Field Search Type 


Bit 12 Message Key = Search Key 

(the third operand) 
Bit 13 Message Key < Search Key 

(the third operand) 
Bit 14 Message Key > Search Key 

(the third operand) 
Bit 15 Not used 


The search type is the logical OR of the I-bits specified. 
For a search type of binary 000x, no keys satisfy the 
search type; therefore a specification exception occurs. 


Note: A receive first operation is accomplished by 
setting the I-field to binary 111x. In this case any 
search key provides the desired operation. However, 
because the third operand is accessed and used in the 
comparison, it is convenient to specify the third operand 
(the search key) as the header address to eliminate a 
potential address translation exception. A zero is forced 
for the length field in the header and the key value is 
ignored for specifications of | = binary 111x. Also, a 
check is not made for a page crossing in the key field if 
enqueue-first or enqueue-last is specified. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The search key specified by the 
third operand must be fullword aligned, is the length 
specified in the queue header, and cannot cross a page 
boundary. 


Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRM descriptor 
— Descriptor access: Monitored SRQ descriptor 
— Descriptor access: Monitored TDE descriptor 
— Effective address overflow 

— Invalid descriptor 

— Specification 
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RECM Example 





Assembler: RECM B,, D2(B-), B3(D3), | 
Machine: D948 5000 6000- 

Before After 
B,(4): 011A 57CD 0200 011A 57CD 0200 
B2(5): OOA5 236B 0000 OO0A5 236B 0000 


B3(6): OOA5 23B0 0000 OOA5 23B0 0000 


Storage — Before and After 


OOA5 23B0 0000 





The message chain is searched for 1 a key value of 01. It 
is found that no message on the SRQ satisfies the equal 
search type. The instruction is nullified and the TDE is de- 
queued from the TDQ [Kg and enqueued to the SRQ list. 
The task issuing the RECM is put into the wait state, and 
the task dispatcher is invoked. 
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Before 


TDQ 


Descriptor 


First TDE Address 
OOOA CB32 A500 










Next TDE Address 


000A CB32 A500 1234 0000 0000 


Bytes 2 










First TDE Address 


OOA5 236B 0000 ABCD 0000 OO000 


\ 
8 
\ | tm § 


Next Message Address 
XXKXX XXKK XXKX 


Bytes 2 






First Message Address 
013B 2AC5 6120 











013B 2AC5 6120 


Bytes 2 8 9 


TDQ 
—" 0, Bit 3 Before 
| Empty=0 | 0 








Instruction Descriptions 10-317 


After 


TDQ 


Descriptor 


First TDE Address 
1234 0000 0000 





0 Bytes 2 


OOOA CB32 A500 


OOAS 236B 0000 


013B 2AC5 6120 
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TDE 
Descriptor Next TDE Address 
ABCD 0000 0000 
0 Bytes 2 
SRQ 
Descriptor First TDE Address 
ae 000A CB32 A500 
0 By tes 2 





First Message Address 
013B 2AC5 6120 





9 A 

SRM 

Next Message Address 
XXXX XXXX XXXX 

0 Bytes 2 















\ 
8 


| rer 


REMOVE PRIMARY DIRECTORY ENTRY (RPDE) 
Instruction Description 


The RPDE instruction is used to remove an entry from 
the primary directory. The primary directory entry is 
identified by the first operand. 


Format: Sl 


QO Bits 8 12 16 20 31 


Operation: The first halfword of the first operand 
contains the hash table index; the high-order bit (bit 0) 
of the hash table entry index is not used to index the 
hash table. The second halfword of the first operand 
contains the PD index, with the high-order 4 bits being 
ignored and treated as zeros. 


If the primary directory (PD) entry identified by the first 
operand is not on the PD chain, a specification 
exception is recognized and the operation is terminated. 
Otherwise, the SID and PID entries (bits 0-39) are 
updated. Bits 0-23 are forced to hex 00 0001: bits 
24-39 are updated by shifting the PD index to the left 
one position and inserting a O into the vacated bit 
position, and bits 40-63 are forced to zeros. The entry 
is then removed from the PD chain. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The first operand occupies a 
word in storage and must begin on a fullword boundary; 
otherwise, a specification exception is recognized and 
the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Note: This instruction should be used only 
to remove an invalid PD entry. 


RPDE Example 


Op D, 
83 074 
31 


0 Bits 8 12 16 20 


Assembler: RPDE D, (B,) 

Machine: 8304 4074 

B, (4): 0000 0100 2480 

Primary Directory: 0000 0103 0000 


Hash Table: 0000 0102 0000 


Storage — Before and After 
2/A 4/C 6/E 


C42 0082 
a 


0000 0100 24F4 


Hash Table 
index 


PD Index 





Storage — Before 









4/C 
0080 


0/8 2/A 


000C 4200 
0020 








0000 0103 0820 





Primary 
Directory 
Entry 






0000 0102 1884 0082 


Hash Table Entry” 






Storage — After 











4/C 
0400 


2/A 
0101 


0/8 


0000 
0020 








0000 0103 0820 Primary 


Directory 






0000 0102 1884 008 Entry 
Hash Table Entry ” 
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RESET ADDRESS COMPARE MODE (RACM) 


Instruction Description 


This instruction resets the saft address compare mode 
previously set by the Set Address Compare Mode 
instruction. 


Format: RR 


Lo | [3 


O Bits 8 12 15 


Operation: 


This instruction resets the address compare enable and 
store-only latches in the virtual address translator, the 
soft address compare flag (byte hex 24, bit 2 of the LSR 
[local storage register |), the microprocessor exception 
flags (byte hex 27, bits 2 and 3 of the LSR), and the 
virtual address-not-mapped flag (byte hex 22, bit O of 
the LSR). 


Overflow and Sign Code: Not applicable. 


Condition Code: 


0 Address compare mode reset or 
no previous Set Address Compare 
Mode instruction executed. 
Address compare mode not reset. 
2 ae 

3 aie 


ah 
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Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


Programming Note: This instruction will not reset an 
address compare that has been entered through the 
console. 


RACM Example 
Op 
OD 
O Bits 8 12 15 
Assembler: RACM 


Machine: ODO3 


LSR Byte 

Hex Bit Description Action 
22 0 FLGO—VA Not Mapped Reset 
24 2 FLG2—Soft Address Compare Reset 
27 2,3 UEX1—Address Compare Status Reset 


RESET CHAIN BUSY (RCB) 


Instruction Description 


This instruction is used to reset the busy bit of the first 
hold record on the object hold chain for the first 
operand. 


Format: RR 


O Bits 8 12 15 


Operation: A 4096 byte hold hash table, whose address 
is given in bytes hex 8A-8F of the control address table, 
is accessed. This hold hash table address is initialized 
by the IMPL to point to the first byte in the table. 


The first operand register contains an object address. 
This 6-byte effective address is hashed to create a 
2-byte index into a hash table. If the chain is empty 
(contains no hold records), the hash table entry is all 
zeros, a specification exception is recognized, and the 
operation is suppressed. 


If the hash table entry for the second operand object 
contains a nonzero value, that value is used as an index 
to access the first hold record in the chain. The 2-byte 
hash table entry is multiplied by 16 and concatenated to 
the right of the high-order 28 bits of the available hold 
record address; found in the control address table. The 
available hold record contents point to the start of the 
hold record area. The busy flag (byte O, bit 5 of the 
hold record) is checked, and if it is a O, a specification 
exception occurs, and the operation is suppressed. If 
the busy flag is a 1, it is reset and the operation is 
completed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Unchanged. 


Carry and Boundary Requirements: Not applicable. 


Program Exceptions: 
— Address translation 


— Addressing 
— Specification 
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RCB Example 


Op |B, 
OD | 3 


0 Bits 8 12 15 


Assembler: RCB B, 
Machine: OD36 


B, (B): 0801 1803 0000 


Control Address Table Hash Table 
~L -L ; ~L —~—L 
100 0088 
100 0092 0801 OCOO 0005 


Hold Records — Before 


; Primary | Secondary | Cumulative 


0801 1802 0000 | 0000; 0000 0000 00 00 
0801 1803 0000 | 0000 0003 0000 00 00 








0801 OCOO 0000 


10 


20 






30 


40 


50 
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Hold Records — After 


; Primary | Secondary | Cumulative 


0801 1802 0000 | 0000 0000 0000 00 00 
0801 1803 0000 | 0000 0003 0000 00 00 
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0801 OCOO O000 


10 


20 





30 






40 


50 





RESET MACHINE CHECK MODE (RMCM) 
Instruction Description 


This instruction is used to reset the processor machine 
check mode after a machine check has been reported. 


Format: RR 


O Bits 8 12 15 


Operation: This instruction signals the HMC that the 
reported error has been processed and another machine 
check can be logged into the MCLB (machine check log 
buffer). 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 
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Carry: Not applicable. 


Boundary Requirements and Program Exceptions: None. 


RMCM Example 


Op 
OD 
O Bits 8 12 15 


Assembler: RMCM 


Machine: ODO2 


J 


RETURN AVAILABLE HOLD RECORD (RAHR) 


Instruction Description 


This instruction is used to return the hold record 
specified to the available hold record chain. 


Format: RR 


O Bits 8 12 15 


Instruction Description: The first operand is a halfword 
index that points to a hold record. This hold record is 
returned to the available hold record chain. The first 
operand contents are not changed. 


The address of the available hold record chain (bytes 
hex 92-98 of the control address table) is converted to 
a hold record index (bits 28-43 of the 6-byte virtual 
address) and the resultant 2-byte value is loaded into 
the object chain field (bytes A and B) of the hold record 
to be returned. The flag byte (0), the TDE identifier field 
(bytes 8 and 9), and the second chain pointer and 
cumulative hold field (bytes C-F) of the hold record are 
set to zero. The address of the hold record is loaded 
into the available hold record chain entry of the control 
address table and the operation is completed. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry and Boundary Requirements: Not applicable. 


Program Exceptions: 


— Address Translation 
— Addressing 
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RAHR Example 


Op 
OD 


O Bits 8 12 15 


Assembler: RAHR R, 
Machine: OD35 


R, (3): 0003 


Storage — Before 


Control Address Table Hash Table 


a oe 










100 0088 


100 0092 0801 OCOO 0050 






Hold Records 


: Primary | Secondary | Cumulative 


0000 0000 0000 | 0101 0002 0001 00 
0000 0000 0000 | 0000 0006 0000 00 





0801 OCOO 0000 


10 


20 





30 






40 


50 
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Storage — After 


Control Address Table Hash Table 


a i 










100 0088 
100 0092 









0801 OCO0 0030 


Hold Records 


; Primary | Secondary | Cumulative 
0000 0000 0000 | 0000 0005 0000 00 00 
0000 0000 0000 | 0000 0006 0000 00 00 
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0801 OCO0 0000 


10 


20 


30 


40 


50 





SCAN (SCAN) 


Instruction Description 


The character string addressed by operand 5 is scanned 
left to right in order to search for the character value 
specified in operand 1. 


Format: SS 
Let [wimie| |p, _ 
O Bits 16 20 32 47 


Operation: The controls operand (operand 1) specifies 
the starting address of a doubleword aligned, 8-byte 
string; a specification exception is signaled for improper 
alignment. The information contained in the controls 
operand is used to control the scan operation. The 
controls operand has the following format: 


eres Meaning 
lo Mode control 











Reserved 








Scan character 


me 


5- String end 
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The mode contro! byte specifies the mode (simple or 
extended) for the base string character and for the scan 
character. When a single mode scan is requested in the 
options mask (operand 3), the base string character and 
the scan character must be specified as having the same 
mode. A specification exception occurs if a mixture of 
modes is specified for a single mode scan. When a 
mixed mode scan is requested in the options mask, the 
base string mode bit is used as both input to and output 
from the instruction. The mode control byte has the 
following format: 


pits [Value [Meaning 
Base string character is in 
simple mode. 
Base string character is in 
extended mode. 


Scan character is in a 
simple mode. 

Scan character is in 
extended mode. 


2-7 000000 Reserved (must be 0). A 
specification exception 
occurs if any bits are not 
0. 


The scan character is either a 1- or a 2-byte value 
depending on the mode as specified in bit 1 of byte O. 
A scan character in simple mode is specified as a 
1-byte value in byte 3 of the controls operand (byte 2 is 
ignored). A scan character in extended mode is 
specified as a 2-byte value (bytes 2 and 3). 


J 





The string end is a 3-byte value specifying the segment 
group offset to the last byte of the string to be scanned. 
This 3-byte value, when concatenated on the right of 
the 3-byte segment group identifier specified in bytes 
0-2 of base register hex D (operand 5), forms the 
6-byte address of the rightmost byte of the string. If 
the base string address specified in operand 5 (base 
register D) points beyond the address of the rightmost 
byte of the string, a not found condition code is set, and 
the instruction is terminated. 


Operand 2 is a displacement value and when combined 
with the value in base register O specifies an address for 
a branch. The branch is taken under control of the 
options mask if an escape code (any value less than hex 
40 with the exceptions listed in the verification step) is 
encountered in the base string during the scan 
operation. 


Operand 3 is an options mask that provides additional 


controls over the scan operation. The options mask has 
the following format: 


jets [value _| Meaning 


Branch on encountering an 
escape code. 

Do not branch on 
encountering an escape 
code. 










Mixed mode scan.' 
fa single mode scan.? 


Reserved. 


\The hex OE and hex OF shift mode characters are 
recognized when mixed mode scan is specified. 


2The hex OE and hex OF shift mode characters are not 
recognized when single mode scan is specified. 


Operand 4 (bits 12, 13, and 14) is used as a mask to 
determine when the scan operation is complete. The 
bits correspond to condition codes O, 1, and 2 
respectively. Bit 15 of operand 4 is reserved. 


The scan operation ends when one of the following 
conditions occur: 


e« Bit 12 is on, and the scan character compares equal 
to the base string character. 


e« Bit 13 is on, and the scan character compares less 
than the base string character. 


e Bit 14 is on, and the scan character compares greater 
than the base string character. 


e The last byte of the base string has been processed, 
and one of the previous conditions has not occurred. 
In this case, a not found condition code is set. 


e A compare mask of all zeros results in completion of 
the instruction with a condition code of not found. 


Operand 5 (base register hex D) specifies the address of 
the leftmost byte of the string to be scanned. When the 
instruction is interrupted or completed, this operand 
contains the address of the last character in the string 
that was scanned. 


The scan operation consists of three possible steps: 
verification, comparison, and increment. 


Verification Step: The verification step determines 
whether the base string value is a mode shift character 
or an escape character. 


One of the following actions occurs if the base string 
charcter has a value less than hex 40. 


e For mixed mode scan (bit 9 of operand 3 is off), if 
the base string byte contains a hex OE value (shift out 
of simple mode) and if the base string is in simple 
character mode (bit O of the mode control byte is 
off), the mode of the base string is changed from 
simple to extended character mode. The scan 
operation bypasses the comparison step and 
continues with the increment step. 


e For mixed mode scan (bit 9 of operand 3 is off), if 
the base string byte contains a hex OF value (shift 
into simple mode), if the base string is in exteneded 
character mode (bit O of the mode control byte is on), 
and if this byte is the first byte of the extended 
character code, the mode of the base string is 
changed from extended to simple character mode. 
The scan operation bypasses the comparison step 
and continues with the increment step. 
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e lf the base string character value is less than hex 40 
and does not result in a mode shift character as 
previously described, and if the escape option has not 
been specified (bit 8 of operand 3 is on), the scan 
operation continues with the comparision step. 


e If the base string character value is less than hex 40 
and is not a mode shift as previously described, and 
if the escape option has been specified (bit 8 of the 
instruction is off), then an escape code has been 
encountered. The updated instruction address is 
replaced by the branch address, and a not found 
condition code is set. The branch address is the sum 
of the displacement (D2) from the instruction and the 
offset portion of the instruction stream base address 
contained in base register 0. 


Escape codes are detected under the following 

conditions: 

— If bit 9 of the instruction is on (single mode scan), 
a byte of the character being processed (both 
bytes are verified in extended mode) contains a 
value less than hex 40. 

— If bit 9 of the instruciton is off (mixed mode scan), 
a byte of the character being processed (both 
bytes are verified in extended mode) contains a 
value less than hex 40, but it is not a valid mode 
shift value. 
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Comparison Step: The scan operation proceeds by 
performing the appropriate comparison (simple or 
extended character mode) of the scan character to the 
base string character. The compare operation is 
performed with both the scan character and the base 
string character treated as unsigned quantities. 


The mode of the scan character must be the same as 
the mode of the base string character; otherwise, no 
compare operation occurs, and the scan operation 
continues with the increment step. 


If the mode of the scan character is the same as the 
mode of the base string character, a comparison is 
performed as follows: 


¢ In simple character mode, the scan character (byte 3 
of the controls operand) is compared with the string 
character currently addressed by operand 5. 


e In extended character mode, the scan character 
(bytes 2 and 3 of the controls operand) is compared 
to the base string character. In extended character 
mode, the base string character consists of 2 bytes 
from the base string. If the rightmost byte of the 
2-byte base string character requires a storage 
access beyond the last byte of the string, the Scan 
instruction is completed with a not found condition 
code. If this condition occurs, operand 5 addresses 
the leftmost byte of the 2-byte base string character 
which is the last byte of the base string. 


If the result of the compare operation corresponds to a 
condition specified by the mask field (operand 4), the 
condition code is set and the Scan instruction is 
completed. 


If the result of the compare operation does not 
correspond to a condition specified by the mask field, 
the scan operation continues with the increment step. 


J 


J 





Increment Step: The purpose of the increment step is to 
alter operand 5 (base register hex D) so that it 
addresses the next base string character to be scanned. 
However, depending on certain conditions, operand 5 
may or may not be altered. 


Operand 5 is not altered and the Scan instruction is 
completed with a not found condition code when one of 
the following conditions exist: 


e The segment group offset value in bytes 3, 4, and 5 
of operand 5 is equal to the base string end value in 
bytes 5, 6, and 7 of operand 1. 


e The segment group offset in bytes 3, 4, and 5 of 
operand 5 is 1 less than the base string end value in 
bytes 5, 6, and 7 of operand 1; a mode shift was not 
encountered; and the base string is being processed 
in extended mode. 


Operand 5 is altered and the Scan instruction continues 
with the verification step when one of the following 
conditions exist: 


e For a mixed mode scan, operand 5 is altered by 1 if a 
mode shift was encountered. 


e Operand 5 is altered by 1 if the base string is in 
simple character mode. 


e Operand 5 is altered by 2 if the base string is in 
extended character mode. 


The scan operation continues with the verification step. 
The Scan instruction can be interrupted at this point, 
except immediately following a shift in or shift out 
character. In this case, the operation is interruptible at 
the next character. 
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The following defines the conditions that can be 
encountered at the end of the string and the ) 
addressability of base register hex D for each case. 


Addressability—Register Hex D 
Ending Condition Points To Response 


Simple character or mode shift 


e Shift into simple character mode Character being compared Mode shift; condition code Not found 
e Shift out of simple character mode | Character being compared Mode shift; condition code Not found 


e Simple character Character being compared Condition code: Not found (unless 
compare mask satisfied) 


e Escape code in simple character First byte of character containing Branch taken 
escape code 


Extended character split across string | First byte of character Condition code: Not found 
end 
« Extended character 


e« Escape code in extended character | First byte of character containing Branch taken 
escape code 


Extended character at string end First byte of character Condition code Not found (unless 
« Extended character compare mask satisfied) 





e« Escape code in extended character | First byte of character Branch taken 


Overflow and Sign Code: Not applicable. Boundary Requirements: The controls operand (operand an 
4) is a doubleword aligned, 8-byte string. A 
specification exception occurs and the instruction is 

Condition Code: suppressed if the controls operand is improperly aligned. 


O Scan character = character in string 
Program Exceptions: 
1 Scan character < character in string 


Address translation 


2 Scan character > character in string — Addressing 
— Effective address overflow 
3 Not found — Specification 


Carry: Not applicable. 
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SCAN Example 


Op |M,/M, D, 
CF |8/A 8F8 
8 


0 Bits 12 16 20 





D, 
0094 
32 47 
Assembler: SCAN D, (B,), Dz, M3, Mg or SCAN S,, D2, M3, Mg 
Machine: CF8A O8F8 0094 
M3(8): 1000 (Binary) Mixed mode, no branch on escape character 
M,(A): 1010 (Binary) Looking for base string character which is 
less than or equal to SCAN character. 


B, (0): 0102 0101 OOOO (Base register for control information) 


Before: B(D): 0103 0101 2CDF (Base register for base string start) 
After: B(D): 0103 0101 2CF6 


Storage — Before 


0102 0101 O8FO 
0102 0101 O8F8 


0103 0101 2CD0 
0103 0101 2CD8 
0103 0101 2CFO 





Storage — After 


0102 0101 O8FO 
0102 0101 O8F8 





Before After 
Condition Code x 0 
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SEND COUNT (SENDC) 
Instruction Description 
The current value of the count field in the SRC 


(send/receive count) designated by the first operand is 
incremented by 1. 


Format: Sl 
O Bits 8 16 20 31 


Operation: If the new count value is greater than or 
equal to the limit value of the SRC and the wait list is 
not empty, if byte O, bit 7 of the SRC equals: 


0 All TDEs (task dispatching elements) 
are dequeued /enqueued 


1 Only the first TDE is dequeued /enqueued 


Byte 0, bit 7 determines the TDEs on the SRC wait list 
that are dequeued and subsequently enqueued in priority 
sequence to the TDQ (task dispatching queue) specified 
by the TDE. TDE bytes hex 16-1B are updated 
accordingly. If a TDE is enqueued at a higher priority 
than the current task, and bit 15 of the instruction 
equals zero, a task switch will occur. 


Execution of the SENDC instruction may be interrupted 

by |/O. If an 1/O interrupt does occur, the interrupt will 
be processed, and instruction processing will resume at 
the point the interrupt was granted. 


I-Field 

Bits Description 

8-14 Not used 

15 Task Switch Control: 


O Task dispatcher to be invoked 
after waiting TDEs are moved 
to the TDQ 

1 Task dispatcher not to be 
invoked 
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Overflow: A counter overflow causes an SRC overflow 
exception. Jo 


Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 
— Invalid descriptor 

— Specification 

— SRC overflow 





SENDC Example 
Op D, 
66 000 
0 Bits 8 16 20 31 


Assembler: SENDC D, (B,), | 
Machine: 6600 4000 


B, (4): OOOA 1B2C 0000 


The count [JJ is incremented by one. The TDE on the 
SRC wait list is dequeued [J and enqueued to the TDQ. 








Before 

TDQaQ 
; First TDE Address 
0 _— Bytes 2 ? 
TDE 
Ec EOAE Next TDE Address Priority 

OE1A F2AE 3100 Descriptor 1234 0000 0000 0000 0001 
0 Bytes 2 8 : 
SRC 












First TDE Address 
1C23 FA34 2B00 






OOOA 1B2C 0000 


Descriptor 
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TDE 


Next TDE Address 


1C23 FA34 2B00 | _ Descriptor ABCD 0000 0000 





0 Bytes 2 














Priority 
0000 0002 


Address of Object Enqueued To 
000A 1B2C 0000 










8 Bytes C 
After 
TDQ 
Desetintor First TDE Address 
OE1A F2AE 3000 OE1A F2AE 3100 
a) Bytes 2 
TDE 
ee Next TDE Address 
OE1A F2AE 3100 escriptor 1023 FA34 2B00 
0 Bytes 2 8 










Priority 
0000 0001 


Address of Object Enqueued To 
OE1A F2AE 3000 


8 Bytes B 1e 
TDE 
: Next TDE Address 
t 
1C23 FA34 2B00 1234 0000 0000 
0 Bytes 2 











Address of Object Enqueued To 
OE1A F2AE 3100 


Priority 
0000 0002 










8 Bytes C 1 
SRC 
; First TDE Address 
t 
0 Bytes 
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SEND MESSAGE (SENDM) 
Instruction Description 


The SRM (send/receive message) addressed by B, is 
enqueued to the message list of the SRO (send/receive 
queue) designated by the second operand. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The enqueuing method is designated by the 
l-field. The message list is searched, in sequence, 
beginning with the first message. The new message 
(the first operand) is enqueued above the first message 
that satisfies the search type. If the list is empty, the 
new message is enqueued first. If the search type is not 
satisfied, the new message is enqueued last. Search 
keys begin in byte 8 of the SRM, have a length 
specified in the queue header, and are treated as 
unsigned binary data. 


The status of byte O bit 7 of the SRQ determines the 
TDEs (task dispatching elements) that are dequeued 
from the SRQ wait list and subsequently enqueued in 
priority sequence to the TDQ (task dispatching queue) 
specified by the TDE. If bit 7 is zero, all TDEs are 
moved. If bit 7 is one, only the top TDE is moved. TDE 
hex bytes 16-1B are updated accordingly. If a TDE is 
enqueued at a higher priority than the current task and if 
bit 15 of the instruction equals zero, a task switch will 
occur. 


I-Field Search Type 
Bit 12 Search message key = 
the first operand message key 
Bit 13 Search message key < 
the first operand message key 
Bit 14 Search message key > the 
first operand message key 
Bit 15 Task switch control: 


0 Task dispatcher to be 
invoked after waiting 
TDEs are moved to the 
TDQ 


1 Task dispatcher not 
to be invoked 





The search type is the logical OR of the I-bits specified. 
Therefore, a specification of | = binary OOOx results in 
enqueue last and | = binary 111x results in enqueue 
first. 


Note: The key length specification in the queue header 
is key length minus 1. Therefore, if enqueue first (binary 
111x) or enqueue last (binary O0Ox) is specified, the 
key/text portion of the SRM must be at least 1 byte 
long. If enqueue-first or enqueue-last is specified, the 
key field is not checked for a page crossing. 


Execution of the SENDM instruction may be interrupted 
by I/O. If an |/O interrupt does occur, the interrupt will 
be processed, and instruction processing will resume at 
the point at which the interrupt was granted. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRM descriptor 
— Descriptor access: Monitored SRQ descriptor 
— Descriptor access: Monitored TDE descriptor 
— Effective address overflow 

— Invalid descriptor 

— Specification 
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SENDM Example ) 
Op D, 
68 000 
12 31 


O Bits 8 16 20 


Assembler: SENDM B,, D2(B2), | 
Machine: 684E 5000 
B, (4): 002B 3245 A120 


B.(5): 0001 FC30 0000 


Before 


TDQ 


First TDE Address 


OE1A FA2E 3000 Descriptor BEI RDAL 3100 





0 Bytes 2 8 


Current TDE 


0E1A F2AE 3100 Hdscrintor Next TDE Address ) 


KXKXXK MKKXX KKKK 





0 Bytes 2 





Priority Address of Object Enqueued To 

0000 0009 0E1A FA2E 3000 
8 Bytes Cc 16 1C 
SRQ 


Key 
: First TDE Address 
0001 FC30 0000 Descriptor anne SEA OEO0 Reserved| Length 
-1=0 





0 Bytes 2 8 9 


First Message Address 
21AB CBO2 DAOO 


Reserved 





A Bytes 10 20 
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C 


Next TDE Address 
12A7 7EAC OFOO ABCD 0000 0000 


Bytes 2 

















Priority Address of Object Enqueued To 
0000 0008 0001 FC30 0000 
8 Bytes C 16 1C 
002B 3245 A120 Next Message Address 
XXXX XXXX XXXX 
Bytes 2 8 9 
21AB CBO2 DAQOO Next Message Address 
XXXX XXXX XXXX 
Bytes 8 9 
After 
Descriptor First TDE Address 
OE1A F2AE 3100 
Bytes 2 8 
Next TDE Address 





Bytes 


Priority Address of Object Enqueued To 


0000 0009 OE1A FA2E 3000 





8 Bytes Cc 16 1C 
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0001 FC30 0000 


12A7 7EAC OFOO 


002B 3245 A120 


21AB CBO2 DAOQO 
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SRQ 


First TDE Address 


Descriptor 
XXX XXXKX XXXX 


0 Bytes 2 


First Message Address 
002B 3245 A120 


TDE 


Next TDE Address 


Descriptor 
XXXX XXXX XXXX 


O Bytes 2 


Priority 
0000 0008 


SRM 
Descriptor Next Message Address 
6C00 21AB CBO2 DAOO 
0 Bytes 2 
SRM 


Next Message Address 


Descriptor 6789 0000 0000 


Since the task switch control bit (bit 15 of the instruction) 
was zero, the task dispatcher is now invoked; and since the 
highest priority TDE on the TDQ is not the current TDE, 
the task dispatcher will switch out the old TDE and switch 
in the new TDE. 


R d Ss 











Address of Object Enqueued To 
OE1A F2AE 3100 


20 











SEND MESSAGE AND WAIT (SENDMW) 


Instruction Description 


The SRM (send/receive message) addressed by B, is 
enqueued to the message list of the SRO (send/receive 
queue) designated by the second operand. 


Format: RS 


0 Bits 8 12 16 20 31 


Operation: The enqueuing method is designated by the 
I-field. The message list is searched, in sequence, 
beginning with the first message. The new message 
(the first operand) is enqueued above the first message 
that satisfies the search type. If the list is empty, the 
new message is enqueued first. If the search type is not 
satisfied, the new message is enqueued last. Search 
keys begin in byte 8 of the SRM, have a length 
specified in the queue header, and are treated as 
unsigned binary data. 


I-Field Search Type 
Bit 12 Search message key = 

the first operand message key 
Bit 13 Search message key < 


the first operand message key 


Bit 14 Search message key > the 
first operand message key 


Bit 15 Not used 


The search type is the logical OR of the |-bits specified. 
Therefore, a specification of | = binary O0Ox results in 
enqueue last and | = binary 111x results in enqueue 
first. 


Ail TDEs (task dispatching elements) on the SRO wait 
list are dequeued and subsequently enqueued in priority 
sequence to the TDQ (task dispatching queue) specified 
by the TDE. TDE hex bytes 16-1B are updated 
accordingly. 


After all TDEs on the SRQ wait list are processed, the 
current TDE is dequeued from the prime TDQ and the 
task dispatcher is invoked. Bit 6 of the TDE descriptor 
is set on to indicate that the TDE is waiting for an SRM 
to be processed. Bit 6 of the SRM descriptor is set on 
to indicate that a TDE should be returned to the TDQ by 
the next OU task SENDM designating this SRM, instead 
of enqueuing the SRM to an SRQ. 


When an HMC task sends an SRM with bit 6 of its 
descriptor on, the message is not enqueued to any 
queue. Instead, the 6-byte TDE address field starting at 
offset hex 7A from the beginning of the SRM is 
considered to be the address of a TDE. This TDE is 
enqueued to the TDOQ specified by the TDE and bit 6 of 
the TDE descriptor and bit 6 of the SRM descriptor are 
reset. The TDE address field must be within the same 
page as the SRM descriptor byte or a machine check 
will occur. 


The TDE address at offset hex 7A from the beginning of 
the SRM is not stored there by HMC, but is assumed to 
be there prior to the execution of the SENDMW 
instruction. 


Note: The key length specification in the queue header 
is key length minus 1. Therefore, if enqueue first (binary 
111x) or enqueue last (binary OOOx) is specified, the 
key/text portion of the SRM must be at least 1 byte 


long. If enqueue-first or enqueue-last is specified, the 
key field is not checked for a page crossing. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 
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Program Exceptions: 


— Address translation 

— Addressing 

— Descriptor access: Busy 

— Descriptor access: Monitored SRM descriptor 
— Descriptor access: Monitored SRO descriptor 
— Descriptor access: Monitored TDE descriptor 
— Effective address overflow 

— Invalid descriptor 

— Specification 


SENDMW Example 

Op D, 

69 000 
O Bits 8 12 16 20 31 
Assembler: SENDMW B,, D3 (B,), | 
Machine: 694E 5000 
B, (4): 002B 3245 A120 


B2 (5): 0001 FC30 0000 
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Before 


i TDQ 


First TDE Address 





OE1A FA2E 3000 Descriptor OE1A F2AE 3100 
0 Bytes 2 8 
Current TDE 


; Next TDE Address 
OE1A F2AE 3100 Descriptor 12A7 7EAC OFOO 








Priority Address of Object Enqueued To 

0000 0008 0OE1A FA2E 3000 
8 Bytes C 16 1C 
SRO 


Key 
First TDE Address Reserved| Length 


0001 FC30 0000 Descriptor 12A7 7EAC OFO0 pee 









First Message Address 
21AB CBO2 DAOO 






Reserved 


A Bytes 10 20 
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TDE 


Next TDE Address 
12A7 7EAC OFOO Descriptor ABCD 0000 0000 





0 Bytes 2 



















Priority Address of Object Enqueued To 
0000 0009 0001 FC30 0000 
8 Bytes Cc 16 
SRM 
M Add 
002B 3245 A120 Next Message ress 
XXXX XXXX XXXX 
0 Bytes 2 8 9 
SRM 
; Next Message Address 
Descriptor 


0 Bytes 2 8 9 


TDE Address 
XXXX XXXX XXXX 


7A Bytes 80 


After 


TDQ 
Descriptor First TDE Address 
12A7 7EAC OFOO 










0 Bytes 2 ‘ 
TDE 
Descriptor Next TDE Address 
OE1A F2AE 3100 P XXXX XXXX XXXKX 


0 Bytes 2 


Priority Address of Object Enqueued To 


0000 0008 XXXX XXXX XXXX 





8 Bytes C 16 1C 
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SRQ 


Cc 0001 FC30 0000 Descriptor First TDE Address Reserved | <°Y 


XXXX XXXX XXXX Length-1 





0 Bytes 2 8 9 











First Message Address 
002B 3245 A120 


TDE 


12A7 7EAC OFOO Descriptor Next TDE Address 
XXXX XXXX XXXX 





0 Bytes 2 


Priority Address of Object Enqueued To 
0000 0009 OE1A FA2E 3000 








SRM 
| Descriptor Next Message Address Key 1 
002B 3245 A120 6CO0 21AB CBO2 DAOO 0000 
8) Bytes 2 8 9 
SRM 


: Next Message Address 
21AB CBO2 DAOQO Descriptor 58986000" 0000 





0 Bytes 2 8 9 


TDE Address 


XXXX XXXKX XXXX 





7A Bytes 80 


Since the task switch control bit (bit 15 of the instruction) 
was zero, the task dispatcher is now invoked; and since the 
highest priority TDE on the TDO is not the current TDE, 
the task dispatcher will switch out the old TDE and switch 
in the new TDE. 
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SET ADDRESS COMPARE MODE (SACM) 


Instruction Description 


This instruction establishes address compare mode; the 
first operand contains the compare address and, 
optionally, a data byte to be used for compare on store. 
The address compare type is specified by the second 
operand. 


Format: Sl 
O Bits 8 16 20 31 


Operation: If bit 15 of the instruction (immediate field) 
equals 1, bits O-7 of the first operand contain a 
character that is compared with the data stored into the 
location at the compare address. 


The second operand specifies the address compare 
type: 


Immediate 
Field 
Bits Value Description 
12-13 00 Instruction stream 
01 Processor data 
10 1/O data 
11 Any 
14 0 Fetch/store 
1 Store only 
15 0 No compare on store 
1 Compare on store 
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exception is to be presented for one or any of the 
storage access types. Bit 14 specifies whether the 
exception is to be recognized for a fetch/store access or 
a store only access. If bit 14 is a 1, bits 12-13 are 
ignored and the exception is recognized for any of the 
store access types. Bit 15 specifies that bits O-7 of the 
first operand are to be compared to the value stored at 
the compare address. If the values are equal, an 
address compare exception is recognized; otherwise 
normal operation continues. If bit 15 is a 1, bits 12-14 
are ignored. 


Bits 12 and 13 specify whether the address compare ' 
) 


First Operand 


Bits Description 
0-7 Character 
8-15 Unused 


16-63 Compare Address 
Overflow and Sign Code: Not applicable. 


Condition Code: 


Address compare mode set » 
Address compare mode not set J 


WQONhmH— Oo 


Carry: Not applicable. 


Boundary Requirements: The operand address from the 
instruction identifies an 8-byte field in storage that must 
be fullword aligned; otherwise a specification exception 
is recognized and the operation is suppressed. 


C 


Program Exceptions: 


Address compare 

Address translation 
Addressing 

Effective address overflow 
Specification 


Programming Notes: 


1. 


If an address stop has previously been set via the 
console, condition code 1 is set and the operation 
completes without disturbing the console stop. If a 
console stop is set after the SACM instruction was 
processed, the address stop set by the SACM 
instruction is overridden. 


. This instruction will not override a compare set 


through the console. 


. The exception produced by an address compare can 


be masked in a TDE. If this exception is masked and 
an address compare occurs due to a previous SCAM 
instruction, the exception mask is reversed by the 
HMC. Therefore the next time this address compare 
occurs, an address exception is presented. 


. The IMP exception handler must mask the address 


compare exception within the TDE whenever an 
address compare exception occurs. Unless the mask 
is set, attempting to execute the IMP instruction on 
which the address compare exception occurred 
results in another address compare exception. 


SACM Example 
Op 
4B 
QO Bits 8 16 20 31 


Assembler: SACM D, (B,), I, 
Machine: 4B08 3024 


B, (3): 0123 4567 8000 


Storage — Before and After 






2/A 4/C 6/E 
0000 


0/8 








0123 4567 8024 







1131 1522 


Address compare on |/O data fetch is set at address 
12C4 1131 1522. 


Before After 


Condition Code: x 0 
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SET CHAIN BUSY (SCB) 
Instruction Description 


The SCB instruction locates the chain of hold records 
for an object address and sets the busy flag in the chain 
so no other grant or free operations can be done on the 
chain. 


The second-operand register contains an object 
address. The SCB instruction locates the hash table 
from the CAT (control address table), hashes the object 
address, selects the entry from the hash table, and 
loads the 6-byte address of the first hold record into 
the first-operand register. The busy flag in the first hold 
record is also set to 1. 


Format: RR 


O Bits 8 12 15 


Operation: The second-operand register contains an 
object address. A 4096-byte HHT (hold hash table) 
whose address is given in bytes hex 8A-8F of the CAT 
is accessed. This HHT address is initialized by an IMPL 
(initial microprogram load) to point to the first byte in 
the page. 


This 6-byte effective address is hashed to create a 
1-byte index into a hash table. The 2-byte hash table 
entry is used as a record index into the segments 
containing the hold chains. The selected 2-byte hash 
table entry (when multiplied by 16 and concatenated to 
the right of the high-order 28 bits of the AHR [available 
hold record] address found in bytes 92-95 of the CAT), 
addresses the first hold record in the chain for the 
second-operand object address and its hash synonyms. 
If the chain is empty (contains no hold records), the 
hash table entry is all zeros. In this case, the 
first-operand register contents are unchanged, and the 
condition code is set to 1. 
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If the hash table entry for the second-operand object 
contains a nonzero value, that value is used as a record 2 
index to access the first hold record in the chain. The 

2-byte hash table entry is multipled by 16 and 

catenated to the right of the high-order 28 bits of the 

AHR (available hold record) address. These bits of the 

AHR point to the start of the hold record area. Bit 5 of 

the first byte of the hold record (the chain busy flag for 

example) is checked. If it is a 1 (indicating the chain is 

already busy), a descriptor access busy program 

exception is recognized and the operation is nullified. If 

the chain busy flag is a zero, it is set to one, the 

address of the first hold record in this chain is loaded 

into the first-operand register, and the condition code is 

set to zero. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


OQ Chain was set busy 
1 Chain was empty 


Carry: Not applicable. ) 


Boundary Requirements: The hold record must be 
quadword aligned; otherwise a specification exception 
occurs and the operation is suppressed. 


Program Exceptions: 
— Address translation 


— Addressing 
— Descriptor access: Busy 


SCB Example 


O Bits 8 12 15 


Assembler: SCB B,, Bz 


Machine: 36DD 


Before After 


B,(D) and B,(D): 8001 1800 0000 8001 OC00 0030 


Base register hex D contains the address of the first hold record 
on the chain after the instruction has executed. 


100 0088 
100 0092 


0801 OCO0O0 





Control Address Table Hash Table 


8001 OCOO 0060 


: Primary Seeondary Cumulative 


The chain busy flag (hex 04) is set by this instruction. 





0000 














0030 O02 | 8001 1801 0000 | 0001 0004 0000 00 00 





0040 | 00 84 | 8001 1802 0000 | 0001 0005 0000 00 00 












0050 02 | 8001 1803 0000 | 0002 0000 0000 00 00 







0060 0000 0000 0000 | 0000 0007 0000 00 00 





0070 
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SET CLOCK COMPARATOR (SETCC) 
Instruction Description 


The current value of the clock comparator is replaced by 
the first operand. 


Format: Sl 


ep | [2 B, | ba 


O Bit 8 12 16 20 31 


Operation: The only bits of the operand that are set in 
the clock comparator are those that correspond to the 
bit positions to be compared with the time-of-day 
clock. The remaining rightmost bits are ignored and are 
not preserved in the clock comparator. If no Set 
Time-Of-Day Clock instruction has been issued prior to 
the SETCC, the results of the compare are 
unpredictable. 


The address of the SRC (send/receive counte:) that 
indicates when the value of the time-of-day clock is 
equal to or greater than the value of the clock 
comparator is indicated in the control address table 
(Figure 2-2). No check for a counter limit of zero is 
made when SETCC is issued. 
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Overflow and Sign Code: Not applicable. ; 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The operand occupies 8 bytes 
in storage and must begin on a word boundary; 
otherwise a specification exception occurs, and the 
operation is suppressed. 


The SRC associated with this instruction must begin on 
a word boundary and be storage resident; otherwise a 
machine check will occur when the send to the counter 
takes place. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


2 


Programming Note: If the value to be set into the clock 
comparator is less than the value of the time-of-day 
clock, the value is loaded in the clock comparator and 
the send count is issued. 


WS 


SETCC Example 


Op E |B, D, 
6D 2/3 1A0 


0 Bit 8 12 16 20 31 


Assembler: SETCC D,({B,) 


Machine: 6D02 31A0 


B, (3): 0000 A1B2 C000 


Storage — Before and After 


0/8 2/A 


0000 A1B2 C1A0 0000 0008 


Clock Comparator — Before 


XXXX ! xxxx | xxxx | XXXX I xxxx | XXX 


0 


Clock Comparator — After 


0000 ! 0000 | 0000 | 0000 | 0000 ! 0000 | 0000; 1000 | 0000 | 0100 |! 00 


0 





I xxxx | xxxx | xxxx : xxxx | xx 


xx XXXX | XXXX 1 Xxxx | XXXxXx | XXXX 


56 64 


{ 
XX | XXXX | xxXXxX I Xxxx | xxxx ! XXXX 


56 64 
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SET INDICATOR (SETIND) SETIND Example 


Op |M, E |B, D, 2 
Instruction Description 5A Be) Te 035 


QO Bits 8 12 16 20 31 
An indicator byte in main storage is set according to the 


condition code and a mask. 
Assembler: SETIND D, (B,), M, 


Format: Sl Machine: 5A91 3035 
5A mliie,|  o, | B, (3): 029C 1A2C 2000 
QO Bits 8 12 16 20 31 


Storage — Before 


Operation: The mask, M,, is compared to the condition 

code and, if a match is found, a hex F1 is stored at the 

first operand location. If no match is found, a hex FO is 029C 1A2C 2035 
stored at the first operand location. 





Overflow and Sign Code: Not applicable. Storage — After 


Condition Code: Not changed. 
029C 1A2C 2035 


Carry: Not applicable. 





Boundary Requirements: None. 


Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 
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SET INTERVAL TIMER (SETIT)} 
Instruction Description 


The current value in one of the interval timers is 
replaced by the first operand. 


Format: Sl 
pea | [a] 1, | 
QO Bits 8 16 20 31 


Operation: Two interval timers are provided. The first 
interval timer is called the task interval timer. 


Only those bits of the first operand that correspond to 
the bit positions to be updated are set in the timer. The 
remaining rightmost bits are ignored and are not 
preserved in the timer. 


When the second interval timer is specified, the SRC 
(send/receive counter), which is used to indicate when 
the value in the interval timer has been decremented to 
zero, is specified in the control address table (Figure 
2-2). 


When the task interval timer is specified, a dispatcher 
timer exception is generated to indicate when the value 
in the task interval timer has been decremented through 
zero. If an untimed task issues a Set Interval Timer 
instruction to the task interval timer, a specification 
exception occurs and the operation is suppressed. Also, 
if a timed task issued a SETIT instruction to the task 
interval timer when task dispatching is disabled, the new 
value is loaded but the task interval timer is not started. 


The selection of the particular interva! timer to be loaded 
with the first-operand interval and the technique for 
handling the interval timer is specified in the I-field. 
l-field values of hex 3-F cause a specification exception 
and the operation is suppressed. 


I-Field Timer Control 
Hex 00 First interval timer (also used 
as task interval timer) 
Hex 01 Second interval timer, single interval 
Hex 02 Second interval timer, repeat interval 


Hex O3-FF Invalid 


If repetitive timing is specified, the interval timer 
function is reinitiated using the value in the repetitive 
interval timer doubleword when the prior interval expires 
and the SRC specified in the control address table is 
used. The repetitive interval timer doubleword is not 
changed by this instruction. 


Overflow: No overflow is indicated if the SRC increment 
Causes a Carry. 


Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: See Overflow. 


Boundary Requirements: The first operand occupies 8 
bytes in storage and must begin on a word boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


The SRC associated with this instruction must begin on 
a word boundary and be storage resident; otherwise a 
machine check will occur when the send to the counter 
takes place. 


A machine check occurs if the repetitive interval timer 


doubleword does not begin on a doubleword boundary 
and is not resident. 
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Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


SETIT Example 


Op D, 
6A 000 
0 Bits 8 16 20 31 


Assembler: SETIT D, (B,), I. 
Machine: 6A00 3000 


B,(3): 0000 1A2C 2000 


Storage — Before and After 


0/8 2/A 


0000 1A2C 2000 0000 0008 


Task Interval Timer — Before 


XXXX | XXXX | XXXX | XXXX XKXXX l XXXX 


0 


Task Interval Timer — After 





Bits 


XXX | XXXX XXXX XX| XX XXXKX XXX X XXX | XXXX j XXXX 


42 


64 


0000! 0000 | 0000 ; 0000 | 0000 ; 0000 | 0000; 1000} 1100! 0100! HOpex | s000x | 3000 | 0008 xxxXx | xxXxXx 


0 


Bits 


42 


ol or 
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SET TIME-OF-DAY CLOCK (SETTOD) 
Instruction Description 


The current value of the time-of-day clock is replaced 
by the first operand. 


Format: Si 


12 


O Bits 8 16 20 31 


Operation: The operand is considered to be an unsigned, 
64-bit, binary number. Only bits of the operand that 
correspond to the bit positions to be updated are set in 
the time-of-day clock. The remaining rightmost bits are 
ignored and not saved in the time-of-day clock. If 
timing functions are still active due to a prior SETCC 
(set clock comparator) instruction, the SETCC is 
canceled and no send count is performed. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operand occupies 8 bytes 
ir. storage and must begin on a word boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

— Effective address overflow 
Specification 








| 


SETTOD Example 


Op D, 
6D 000 
12 31 


O Bits 8 16 20 
Assembler: SETTOD D, (B,) 


Machine: 6D04 3000 


B, (3): 0000 A415 3000 


Storage — Before and After 


0/8 2/A 4/C 6/E 
0000 A415 3000 00OA4 OO0E 2100 #0000 





Time of Day Clock — Before 


I | 
XXXX XX XX XXXX | XXXX XXXX XXXX XXXX XXXX XXXX | XXXX | XX/XXK XXXX XXXX | XXXX 200% | 000 


0 Bits 42 56 64 


Time of Day Clock — After 


0000 ! 0000 ; 1010} 0100 } c000 | 0000 | 0000! 1110; 0010 | 0001! 00}xx } 200. | 200% oo 0000 |} 0000 


0 Bits 42 56 64 
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SHIFT LEFT ARITHMETIC (SLA) 


Instruction Description 


The integer part of the first operand is shifted left the 
number of bits specified by the |, field. 


Format: SS 


O Bits 8 12 15 


Operation: The value in I, is 1 less than the number of 
bits to be shifted. All 15 integer bits of the first operand 
participate in the left shift, and zeros are supplied to the 
vacated rightmost register positions. 


Overflow: If a bit unlike the sign bit is shifted out of 
position 1, a binary overflow exception occurs. 


Sign Code: The sign of the first operand remains 
unchanged. 


Condition Code: 
O Result = O 
1 Result < O 
2 Result > O 
a 
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Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: Binary overflow 


SLA Example 


O Bits 8 12 15 
Assembler: SLA Rj, I2 
Machine: 03A2 

Before After 
R, (A): 0A 50 


Condition Code: x 2 





SHIFT LEFT HALFWORD AND COUNT (SLHCT)- 
Instruction Description 


The second operand is shifted left until a 1 bit is shifted 
out of the leftmost bit position. A value equal to the 
number of bits shifted out is placed in the byte register 
specified by r,. 


Format: RS 


0 Bits 8 12 16 20 31 


Operation: The second operand occupies a halfword in 
storage. All 16 bits of the second operand participate in 
the shift left, and zeros are supplied to the vacated 
rightmost bit positions. 


If the second operand contains no 1 bits, no shift 


occurs, and the value zero is placed in the byte register 
specified by r,. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The halfword storage operand 
must start on a halfword boundary; otherwise, a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


SLHCT Example 


r, 
C 


O Bit 8 12 16 20 31 


Assembler: SLHCT r,, D2 (B23) 

Machine: 61CO 3120 

B,(3): 0014 6A3B FOOO 
Before After 


r,(C): XX 09 


Storage — Before 


0014 6A3B F120 





Storage — After 


0014 6A3B F120 
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SHIFT LEFT LOGICAL (SLL) 
Instruction Description 
The first operand is shifted left the number of bits 


specified by |,. 


Format: RR 


O Bits 8 12 15 


Operation: The value contained in the I, field is 1 less 
than the number of bits to be shifted. 


All 16 bits of the first operand participate in the shift 
left, and zeros are supplied to the vacated rightmost 


register positions. Bits shifted out of the register are 
lost. 


Overflow and Sign Code: Not applicable. 
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Condition Code: Not changed. ) 
Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


SLL Example 
I, 
2 
O Bits 8 12 15 
Assembler: SLL R,, I. 
Machine: 0162 
Before After 


R,(6): C4BE 25F0 


SHIFT RIGHT ARITHMETIC (SRA) 
Instruction Description 
The integer part of the first operand is shifted right the 


number of bits specified by I,. 


Format: RR 


O Bits 8 12 15 


Operation: The value contained in the I, field is 1 less 
than the number of bits to be shifted. 


All 15 integer bits of the first operand participate in the 


shift right, and bits equal to the sign are supplied to the 
vacated bit positions. Bits shifted out are lost. 


Overflow: Not applicable. 


Sign Code: The sign of the first operand remains 
unchanged. 


Condition Code: 


0 Result = 0 
1 Result < 0 
2 Result > 0 
3 as 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


SRA Example 


Op 
04 
O Bits 8 12 15 
Assembler: SRA R,, I, 
Machine: 0453 
Before After 


R, (5): C5E6 FC5E 


Condition Code: x 1 
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SHIFT RIGHT LOGICAL (SRL) 
Instruction Description 
The first operand is shifted right the number of bits 


specified by l.,. 


Format: RR 


O Bits 8 12 15 


Operation: The value in |, is 1 less than the number of 
bits to be shifted. 


All 16 bits of the first operand participate in the shift 
right, and zeros are supplied to the vacated leftmost 
register positions. Bits shifted out are lost. 


Overflow and Sign Code: Not applicable. 
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Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


SRL Example 


0 Bits 8 12 15 

Assembler: SRL R,, |; 

Machine: 0243 
Before After 


R, (4): C5E6 OC5E 


This page is intentionally left blank. 
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STACK (STACK) 
Instruction Description 


The Stack instruction obtains and loads the address of 
the next stack entry into the first operand. The stack 
instruction is used by VMC to control the allocation of 
storage. The storage area is organized like a stack. 
Every storage allocation starts on a 16-byte boundary. 
This allows a variable in storage to have any of the 
following boundary alignments: byte, halfword, word, 
doubleword, or quadword. 


The maximum size of a storage allocation is limited to 
64 K-16 bytes. 


Format: RR 


O Bits 8 12 15 


Operation: The size of the next stack entry is indicated 
by the second operand. 


The first operand initially contains the address of the 
current stack entry ii. The first 8 bytes of the current 
stack entry contain four halfword fields that are used by 
the Stack and Unstack instructions. The first halfword 
contains an offset value which, when concatenated 
to the SID (segment identifier) portion of the current 
stack entry address, forms the address of the first byte 
of the next stack entry. The second halfword in the 
current stack entry contains an upper limit Il for the 
stack. The third and fourth halfwords are not used by 
the Stack instruction. 


The address of the stack entry following the next entry 
[9 is formed by adding the value contained in the first 
halfword of the current stack entry to the second 
operand. Both values are considered to be 16-bit 
unsigned binary integers. If no overflow occurs, the sum 
is logically compared with the limit value contained in 
the second halfword of the current stack entry. If the 
sum is greater than the limit value, a stack exception 
occurs and the operation is suppressed. If no stack 
exception is found, the sum is then checked to ensure 
that it is a multiple of eight (doubleword aligned). If it is 
not, a specification exception occurs and the operation 
is suppressed. 
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The following information is then stored into the first 8 
bytes of the next stack entry: J 


Bytes Description 


0-1 Address of the stack entry following the 
next entry. 
2-3 Stack limit value from current stack entry. 
4-5 Address (offset portion) of the current 
stack entry. 
6-7 Flag field that is set to all zeros. 


Finally, the offset portion of the first-operand register is 
loaded with the offset portion of the next stack entry 
address, thus making this next entry the new current 
entry. 


Overflow: If an overflow occurs as the result of add 
operation, an effective address overflow exception 
occurs and the operation is suppressed. 


Sign Code: Not applicable. 
Condition Code: Not changed. > 
Carry: Not applicable. 


Boundary Requirements: Initially, the first operand must 
start on a doubleword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


The concatenation of the offset value from the first 
halfword of the current stack to the SID portion of the 
current stack entry address must be doubleword aligned; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Addressing 

Address translation 
Effective address overflow 
Specification 

Stack 


Programming Note: If the operand specifies a length of 
zero, the results are unpredictable. 


STACK Example 

Op 

1B 
O Bits 8 12 15 
Assembler: STACK B,, R2 
Machine: 1B35 

Before After 

B,(3): 0400 BA1C 4000 0400 BAIC 6330 


R2(5): O4B0 


0400 BAiC 4000 


0400 BA1C 6330 
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STORE (ST) 
Instruction Description 
The first operand is stored at the second-operand 


location. 


Format: RS 


12 


0 Bits 8 16 20 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 


Boundary Requirements: The storage operands must 
start on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


The concatenation of the offset value from the first 
halfword of the current stack to the SID portion of the 
current stack entry address must be doubleword aligned; 
otherwise, a specification exceptions occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 
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ST Example ) 
Op 
96 
12 


0 Bits 8 16 20 31 
Assembler: ST B,, D2(B2) 
Machine: 9630 4250 

B,(3): 04A5 2330 0000 


B2({4): 04C6 3250 1000 


Storage — Before 


0/8 2/A 
04C6 3250 1250 XXXX XXXX 





Storage — After 


0/8 2/A 
04C6 3250 1250 04A5 2330 





STORE AND SET COMPUTATIONAL ATTRIBUTES 
(SSCA) 


Instruction Description 


The current computational attributes of the task are 
stored into the receiver (operand 1). The new 
computational attributes of the task are set from the 
source (operand 2) as determined by the controls 
operand (operand 3). In addition, the current 
computational attributes of the task can optionally be 
stored in the current invocation control block. The 
invocation control block is addressed by base register 3, 
and the attributes are stored under control of indicators 
in the invocation contro! block. 


Format: SS 


8 12 


O Bits 16 20 32 36 47 


Operation: The first operand, the receiver, is always 
specified and is addressed through the base 
displacement (bits 16 through 31). 


The second operation, the source, is optional if third 
operand is not specified. The absence of the second 
operand is indicated by a value of all zeros for bits 32 
through 47. A nonzero value for bits 32 through 47 
specifies the base displacement to be used to address 
the second operand. If the second operand is not 
specified when the third operand is specified, a 
specification exception results. 


The third operand, the controls, is optional. The 
absence of the third operand is indicated by a value of 
all zeros for bits 8 through 11. A nonzero value for bits 
8 through 11 specifies the base register to be used to 
address the third operand. 


All three operands (receiver, source, and controls) have 
the same format with the meaning of the values 
contained within them varying slightly. The common 
operand format is as follows: 


Exception Exception Com 
Mask Occurrence 


0 Bytes 2 4 





Exception Mask 


Byte(s) 
0-1 Bits Meaning 
0-9 Reserved (binary 0) 
10 Floating-point overflow 
11 Floating-point underflow 
12 Floating-point zero divide 
13 Floating-point inexact result 
14 Floating-point invalid operand 
15 Reserved (binary 0) 


Exception Occurrence 


Byte(s) 
2-3 Bits Meaning 
0-9 Reserved (binary 0) 
10 Floating-point overflow 
11 Floating-point underflow 
12 Floating-point zero divide 
13 Floating-point inexact result 
14 Floating-point invalid operand 
15 Reserved (binary 0) 
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Computational Mode 


Byte 4 Bits Meaning 


0 Reserved (binary 0) 
1-2 Rounding mode 


00 = Round towards positive 
infinity 


01 = Round towards negative 
infinity 


10 = Round towards zero 


11 = Round to nearest 


3-7 Reserved (binary 0) 


The receiver and source operand bit values for the 
exception mask and occurrence bits have the same 
meaning. 


Exception Occurrence 
Exception Mask Bits Bits 


O = Exception is masked O = Exception has not 


occurred 


1 = Exception is unmasked 1 = Exception has 
occurred 


The meaning of the receiver and source operand bit 
values for the computational mode are as defined under 
the operand format previously described. 


The bit values in the controls operand determines which 
computational attributes of the task are to be set from 
the bit values in the source operand. A value of O for a 
bit in the controls operand indicates that the 
corresponding computational attribute of the task is not 
to be set from the value of that bit of the source 
operand. A value of 1 for a bit in the controls operand 
indicates that the corresponding computational attribute 
of the task is to be set from the value of that bit on the 
source operand. For an attribute controlled by a multiple 
bit field, such as the rounding modes, all of the bits in 
the field must be ones or all of the bits must be zeros. 
A mixture of ones and zeros in such a field causes a 
specification exception. 
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The operation performed by the instruction is dependent 
on the number of operands specified. 


The initial function of storing the computational 
attributes of the task is always performed. The receiver 
is set with bit values that reflect the computational 
attributes in effect at the start of execution of this 
instruction. Additionally, if the computational attributes 
of the task are to be altered by the value of the source 
operand, the computational attributes of the task are 
optionally stored into the current invocation control block 
(ICB) addressed by base register hex 3. In the ICB, if bit 
7 of the byte at hex offset 06, contains a value of 1 (see 
Note 1) and bit O of the byte at offset hex A9 contains 
a value of O (see Note 2), the computational attributes 
of the task are stored into the ICB at offset hex EO (see 
Note 3) in the format defined for the receiver operand. 
Also, in this case, bit O at byte offset hex AQ is set with 
a value of 1 to indicate the attributes have been stored. 


If the source (operand 2) is specified without the 
controls (operand 3), the computational attributes of the 
task are set with the attributes specified in the source 
operand. If the source is not specified, the instruction 
does not alter the computational attributes of the task. 


If the controls (operand 3) is specified, the source, 
operand 2, must also be specified. The computational 
attributes of the task are set with those attributes 
specified in the source for which the controls contains 
corresponding bit values of 1. Bit values of O in the 
controls indicate that the corresponding attribute is not 
to be set from the value in the source operand. If the 
controls are not specified, the computational attributes 
of the task are set with all of the values specified in the 
source operand. 


2 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The result obtained from 
overlapping operands is unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


Notes: 


1. 


2. 


This bit, AIITYPE, indicates the ICB is an MI ICB if it 
has a value of 1. 

This bit, currently reserved in the ICB, is used to 
indicate whether the computational attributes have 
already been stored for this MI invocation. A value of 
O indicates they have not been stored. A value of 1 
indicates they have been stored. 


. This area of the ICB, a new extension, is used as the 


storage area for the 5 bytes of computational 

attribute information to be stored on an MI invocation 
basis. This area will only be set with this information 
by this instruction upon a change to the attributes, 
thereby avoiding this overhead to the Call External 
instruction path. It allows for Return External Instruction 
exception handing, and invocation exit handling, to 
restore the attributes to those that were in effect 

prior to an MI invocation which is being destroyed. 


SSCA Example 


OP |B, D, D, 

BE F 083 088 
0 Bit 8 12 16 20 32 36 47 
Assembler: SSCA D,(B,), D, (B,), B3 
Machine: BEF8 2083 2088 


B, (2) and B,(2): 800D OC00 0000 


B3(F): 800D OCOO 0301 


Storage — Before 





0/8 2/A 
800D OCOO 0083 xX 
800D OCOO 0088 001C 0000 
800D OCOO 0300 0004 # £=+Q004 
Storage — After 
800D OCOO 0083 
800D OCOO 0088 
800D OCOO 0300 
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Instruction Descriptions 


STORE AND SET TAGS (STST) 

Instruction Description 

The STST instruction provides support for building a 
Machine Interface pointer from the address value 
contained in the first operand. The address value 
contained in the first operand is stored in the pointer 


along with the segment group extender. 


A quadword containing a virtual address is tagged and 
is stored at the second-operand location. 


Format: RS 


12 


O Bits 8 16 20 31 


Operation: The quadword is formed as follows: 


¢ Bits O and 1 of byte O J come from the leftmost 2 
bits of the I, field. 


Pointer Bits 

0 and 1 Meaning 
00 System Pointer 
01 Instruction Pointer 
10 Space Pointer 
11 Data Pointer 


¢ Bits 2 through 7 of byte O [Bj are reset. 


¢ Bytes 1 through 7 [EW are reset. 
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- Bytes 8 and 9 come from a halfword in storage 
whose address is determined by taking bytes 0, 1, 
and 2 of the first operand and concatenating hex O 
0004 on the right. 

e Bytes hex A-F come directly from the first operand, 
bytes 0-5 [i 

Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The second operand must start 


on a quadword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


J 


STST Example 


0 Bit 8 12 16 20 31 
Assembler: STST B,, D2(B2), I3 
Machine: 6558 20F0 

B, (5): 0014 AOOO 3FD6 


B,(2): 0001 5005 0000 


Storage — Before 









0001 5005 OOFO 


0014 AQO00 0004 


4 Storage — After 
2/A [Kya/c 


rt 
8000 0000 0000 #«o000 


0050 _0014 A000 3FD6 
0050 











0/8 
(112) 


0001 5005 OOFO 


6/E 

















0014 A000 0004 
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STORE BYTE (STB) 
Instruction Description 


The first operand is stored at the second-operand 
location. 


Format: RS 


(76 tnlole| o, 
8 12 


0 Bits 16 20 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements: None. 
Program Exceptions: 

— Address translation 


— Addressing 
— Effective address overflow 
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STB Example 


2 
Op 
76 
O Bit 8 12 16 20 31 


Assembler: STB r,, D2 (Bz) 
Machine: 7680 5100 
r, (8): D3 


B2(5): OOOC 1234 0000 


Storage — Before 


OOOC 1234 0100 





Storage — After 


OO0O0C 1234 0100 








This page is intentionally left blank. 
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STORE CLOCK COMPARATOR (STCC) 
Instruction Description 
The current value of the clock comparator is stored at 


the first-operand location. 


Format: Sl 


0 Bit 8 12 16 20 31 


Operation: Zeros are provided for the rightmost bit 
positions that are not used for comparison with the 
time-of-day clock. If no Set Clock Comparator 
instruction has been issued prior to the STCC, an 
unpredictable value is stored. 


Overflow and Sign Code: Not applicable. 
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Condition Code: Not changed. ) 
Carry: Not applicable. 


Boundary Requirements: The first operand occupies 8 
bytes in storage and must begin on a word boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 





STCC Example 


Op D, 
6D 2CO 
12 31 


0 Bits 8 16 20 


Assembler: STCC D, (B,) 
Machine: 6D03 52CQ 
B, (5): 01A0 CDEF 0000 


Clock Comparator — Before and After 


0000 ; 0000 | 0000 | 0101 | 1010 | 0001 | 0000 |} 1011 | 0010 ; 0010 | 10/00 | 0001 | 0011 ; 1110 | 1100 ! 0100 


0 Bits 42 56 64 


Storage — Before 


01A0 CDEF 02C0 





Storage — After 


0/8 2/A 
01A0 CDEF 02C0 0005 $=A10B 
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STORE HALFWORD (STH) 
Instruction Description 


The first operand is stored at the second-operand 
location. 


Format: RS 


O Bitt 8 12 16 20 31 


Operation: See Instruction Description. 
Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 


Boundary Requirements: The storage operands must 
each start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 
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STH Example 
| 

Op D, an 
86 AAO 

O Bit 8 12 16 20 31 

Assembler: R,, Dz (Bz) 

Machine: 8640 3AA0 

B2(3): 2154 C158 0000 


R, (4): FFFF 


Storage — Before 


215A C158 0000 





Storage — After 


215A C158 0000 





This page is intentionally left blank. 
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STORE INTERVAL TIMER (STIT) 
Instruction Description 


The current value in one of the interval timers is stored 
at the first-operand location. 


Format: Sl 


pec ti} |e} 


0 Bit 8 12 16 20 31 


Operation: Zeros are provided for the rightmost bit 
positions that are not updated by the interval timer. If 
no Set Interval Timer instruction has been issued prior 
to the STIT instruction, an unpredictable value is stored. 
Since an untimed task cannot set the task interval timer, 
any STIT instruction issued by an untimed task to the 
task interval timer results in an unpredictable value being 
stored. 


The second operand selects the specific timer for the 
store operation. The second operand values of hex 
02-OF causes a specification exception and the 
operation is suppressed. 


I-Field Timer 

Hex 00 First interval timer (also 
used as task interval timer) 

Hex 01 Second interval timer 


Hex O2-FF Invalid 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The first operand occupies 8 
bytes in storage and must begin on a word boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Execeptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 





STIT Example 


Op 
8C 
O Bits 8 16 20 31 


Assembler: STIT D,(B,), I, 
Machine: 8C01 3220 
B, (3): 2F1A 3CD1 0000 


Interval Timer 


0001! 1010 }1011 | 0010 | GO00 | 0011 | 1100 ; 0100 | 0101 ; 1101 ; 01]10 | 0111 | 1000 | 1110 1111 | 1011 


0 Bits 42 56 64 


Storage — Before 


2F1A 3CD1 0220 





Storage — After 


0/8 2/A 
2F1A 3CD1 0220 1AB2 03C4 
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STORE MULTIPLE (STM) STM Example 


Instruction Description Op B, D, 
97 C 1BO 
12 31 


A set of registers is stored at the locations designated 0 Bits 8 16 20 
by the second-operand address. 


Assembler: STM B,, l3, D, (B> ) 


Format: RS Machine: 9704 C1BO 
97 [aliie| o, _ B2(C): 003F CFDS 0000 
O Bit 8 12 16 20 31 


B(O): 001B 2A30 0000 
B(1): OC3B 1234 4000 
B(2): 0001 ABCD E000 
B(3): 213A C1F4 6000 
B(4): A100 000B A000 


Operation: The first-operand field identifies the first 
register to be stored, and the |, field specifies the 
number of additional registers to be stored. 


The storage area where the contents of the registers are 
stored starts at the location specified by the 
second-operand address and continues through as many 


locations as needed. 003F CFD5 0000 


Storage — Before 


The registers are stored in the ascending order of their 
addresses, starting with the register specified by the 
first operand. The register addresses wraparound from 
hex F to 0. 





Storage — After 
Overflow and Sign Code: Not applicable. 


003F CFD5 0000 
Condition Code: Not changed. 


Carry: Not applicable. 





Boundary Requirements: The storage operands must 
each start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 
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STORE MULTIPLE BYTE (STMB) 
Instruction Description 


A set of registers is stored at the locations designated 
by the second-operand address. 


Format: RS 
[7 Intute! o, 
O Bits 12 16 20 31 


Operation: The first-operand field identifies the first 
register to be stored, and the |, field specifies the 
number of additional registers to be stored. 


The storage area where the contents of the registers are 
stored starts at the location specified by the 
second-operand address and continues through as many 
locations as needed. 

The registers are stored in the ascending order of their 
addresses, starting with the register specified by the 


first operand. The register addresses wraparound from 
hex F to 0. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


STMB Example 


O Bits 12 16 20 
Assembler: STMB rj, 13, D2 (Bz) 
Machine: 77D3 3000 


B,(3): 5FC3 0001 CO00 


r(D): 2A 
r{E): CB 
r(F): £1 
r(O): 4D 


Storage — Before 


5FC3 0001 COOD 





Storage — After 


5FC3 0001 COOD 
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STORE MULTIPLE HALFWORD (STMH) 
Instruction Description 


A set of registers is stored at the locations designated 
by the second-operand address. 


Format: RS 


(s7 iri ie) 
8 12 


O Bits 16 20 31 


Operation: The first-operand field identifies the first 
register to be stored, and the I-field specifies the 
number of additional registers to be stored. 


The storage area where the contents of the registers are 
stored starts at the location specified by the 
second-operand address and continues through as many 
locations as needed. 


The registers are stored in the ascending order of their 
addresses, starting with the register specified by the 


first operand. The register addresses wraparound from 
hex F to 0. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: The storage operands must 
each start on a halfword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 
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Program Exceptions: ) 


Address translation 
Addressing 

Effective address overflow 
Specification 


STMH Example 

Op 

87 
O Bits 8 12 16 20 31 
Assembler: STMH R;,, I3, D2 (Bz) 
Machine: 8752 3100 
B2(3): OOOA OOOB 0000 
R(5): 1234 


R(6): 5678 
R(7): 9YABC 


Storage — Before 


OOOA OOOB 0100 





Storage — After 


0/8 2/A 
OOOA 000B 0100 | 1234 5678 





STORE SPACE OFFSET POINTER (STSOP) 
Instruction Description 


The segment group offset (low-order 3 bytes) of the 
first operand is decremented by the space locator offset 
referenced by the first operand; the 4-byte result is 
stored in the second operand. 


Format: RS 


12 


0 Bits 8 16 20 31 


Operation: The space locator is a 3-byte logical binary 
field located at the storage address found by 
concatenating hex 00 0001 to the right of the 
high-order 3 bytes (segment group identifier) of the 
first-operand address. The space locator is logically 
subtracted from the low-order 3 bytes (segment group 
offset) of the address found in the first operand. If a 
binary underflow results, a specification exception is 
recognized and the operation is suppressed. Otherwise, 
the resultant 3-byte difference is padded on the left 
with 1 byte of zeros, and the result is stored at the 
location specified by the second operand. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


STSOP Example 


Op |B, 
83 8 
O Bits 8 12 16 20 31 


Assembler: STSOP B, ,D2(B2) 
Machine: 8389 2020 

Before After 
B,(8): 0010 0212 3456 0010 0212 3456 


B,(2): 00C1 BOOO 4BE0 00C1 BOOO 4BE0 


Storage — Before 


0010 0200 001D 


00C1 BOOO 4BE0 





Storage — After 
0/8 2/A 


0010 0200 01D0 0034 56xx 
00C1 BOOO 4BE0 0012 0000 
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STORE TIME-OF-DAY CLOCK (STTOD) 
Instruction Description 


The current value of the time-of-day clock is stored at 
the operand location. 


Format: Sl 


12 


0 Bits 8 16 20 31 


Operation: The value of the clock is expressed as an 
unsigned 64-bit binary number. Successive STTOD 
instructions ensure unique values by adding a binary 1 
to bits 56-63. Zeros are provided for the bit positions 
to the left of bit position 56 that are not updated by the 
time-of-day clock. If a Set Time of Day Clock 
instruction is not issued prior to the STTOD instruction, 
an unpredictable result is stored. 
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Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: A carry from bit position 56 is ignored. 


Boundary Requirements: The first operand occupies 8 
bytes in storage and must begin on a word boundary; 
otherwise a specification exception occurs and the 
operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
Specification 


C 


STTOD Example 


Op D, 
6D CAO 
31 


O Bits 8 12 16 20 
Assembler: STTOD D, (B;) 
Machine: 6D05 3CA0 

B, (3): 0005 35A6 1000 


Time-of-Day Clock 


0000 ! 0000 } 0010 ! 1010 | 0001; 0010 | 1100 | 1101; 0010 ; 0000 ! OO|00 '0000 | 0000 | 0000 | 0110 | 0001 


0 Bits 42 


Storage — Before 


0005 35A6 1CA0 





Storage — After 


0/8 2/A 
0005 35A6 1CA0 002A 12CD 





56 64 


Instruction Descriptions 
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SUBTRACT CHARACTERS (SC) 
Instruction Description 


The second operand is subtracted from the first operand 
and the difference is placed in the first-operand 
location. 


Format: SS 


ull! |e; 
8 12 


0 Bits 16 20 32 36 47 


Operation: The operands are treated as signed binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a rightmost one 
bit were added to the first operand. If the operands are 
unequal in length, the shorter operand is considered to 
be extended to the left with bits equal to the sign bit. 


Overflow: If the carry from the sign bit position and the 
carry from the high-order numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. 


If the first operand is too short to contain all significant 
bits of the result, an overflow occurs and significant bits 
are lost. 


Sign Code: The sign bit of the difference is not changed 
after the overflow. A positive result that overflows 
yields a negative difference and a negative result that 
overflows yields a positive difference. 


Note that the sign of the difference is unpredictable 
when significant bits are lost (see Overflow). 
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Condition Code: |f an overflow occurs, the condition 
code indicates the sign the difference would have if an 2 
overflow had not occurred. When significant bits are 

lost, the condition code indicates the sign the difference 

would have if the first operand had been long enough to 

contain all significant bits of the result. 


0 Difference = O 
1 Difference < O 
2 Difference > O 
3 ive 


Carry: See Overflow. 


Boundary Requirements: The operands can overlap in 
storage if the rightmost byte of the first operand is 
coincident with or to the right of the rightmost byte of 
the second operand; otherwise the overlap is destructive 
and the results are unpredictable. 


Program Exceptions: 


Address translation 


Addressing ) 
Binary overflow 


Effective address overflow 





SC Example 


Op D, 

C1 B20 
0 Bits 12 16 20 32 36 47 
Assembler: SC D,(Ly, Bi), D.(L,, Ba) 
Machine: C133 31A0 4B20 


B, (3): 01C2 6430 0000 


B2 (4): 02B0 6320 0000 


Storage — Before 


0/8 2/A 
01C2 6430 01A0 OO1E 8480 
02B0 6320 0B20 0007 A120 





Storage — After 


0/8 2/A 
01C2 6430 01A0 0016 E360 
02B0 6320 0B20 0007 A120 





Before After 


Condition Code: x 2 


Instruction Descriptions 
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SUBTRACT HALFWORD (SH) 
Instruction Description 


The second operand is subtracted from the first operand 


and the difference is placed in the first-operand register. 


Format: RS 


0 Bit 8 12 16 20 31 


Operation: The operands are treated as signed binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a rightmost 1 
bit were added to the first operand. 


Overflow: If the carry from the sign bit position and the 
carry from the high-order numeric bit position agree, no 
overflow occurs; if they disagree, an overflow occurs. 


Sign Code: The sign bit of the difference is not changed 
after the overflow. A positive result that overflows 
yields a negative difference and a negative result that 
overflows yields a positive difference. 


Condition Code: If the overflow occurs the condition 
code indicates the sign the difference would have if 
overflow had not occurred. 


0 Difference = O 
1 Difference < O 
2 Difference > O 
3 as 
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Carry: See Overflow. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception is recognized, and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Binary overflow 

Effective address overflow 
Specification 


SH Example 
Panne 
80 OAO 
O Bit 8 12 16 20 31 

Assembler: SH R,, D2(B2) 

Machine: 8061 30A0 

B, (3): 001F F100 10A0 
Before After 

R , (6): 1388 OFAO 


Condition Code: x 2 


Storage — Before and After 


001F F100 1140 





J 


SUBTRACT HALFWORD REGISTER (SHR) 
Instruction Description 


The second operand is subtracted from the first operand 
and the difference is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a rightmost 1 
bit were added to the first operand. 


Overflow: \f the carry from the sign bit position and the 
carry from the high-order numeric bit position agree, the 
difference is satisfactory; if they disagree, an overflow 
occurs. 


Sign Code: The sign bit of the difference is not changed 
after the overflow. A positive result that overflows 
yields a negative difference, and a negative result that 
overflows yields a positive difference. 


Condition Code: |f an overflow occurs the condition code 
indicates the sign the difference would have if overflow 
had not occurred. 


0 Difference = O 
1 Difference < O 
2 Difference > O 
3 a 


Carry: See Overflow. 
Boundary Requirements: None. 
Program Exceptions: Binary overflow. 


SHR Example 

R, 

7 
O Bits 8 12 15 
Assembler: SHR R,, R2 
Machine: 2167 


Before After 


Ri: 1388 OFAO 
R»: O3E8 O3E8 
Condition Code: x 2 
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SUBTRACT LOGICAL BYTE (SLB) 
Instruction Description 


The second operand is subtracted from the first operand 


and the difference is placed in the first-operand register. 


Format: RS 


pm tilole| o 
8 12 


0 Bits 16 20 31 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a low-order 1 
bit were added to the first operand. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Difference # O, with no carry 
Difference = O, with carry 
Difference # O, with carry 


ON — Oo 


Carry: A carry from the high-order bit position is 
recorded in the condition code. 
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Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


SLB Example 


Op D, 
71 Coo 
O Bits 8 12 16 20 31 
Assembler: SLB r1, D2 (Bz! 


Machine: 7150 3C00 


Bz (3): CA20 1254 3000 


Before After 
rz, (5): 64 32 
Condition Code x 1 


Storage — Before and After 


CA20 1254 3C00 





SUBTRACT LOGICAL BYTE REGISTER (SLBR) 
Instruction Description 


The second operand is subtracted from the first operand 


and the difference is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a low-order 1 
bit were added to the first operand. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Difference # O, with no carry 
Difference = O, with carry 
Difference # O, with carry 


WN — © 


Carry: A carry from the high-order bit position is 
recorded in the condition code. 


Boundary Requirements and Program Exceptions: None. 


SLBR Example 


QO Bits 8 12 15 
Assembler: SLBR r,,r2 
Machine: 1134 


Before After 


r, (3): 64 32 
rz (4): 32 32 
Condition Code: x 1 
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SUBTRACT LOGICAL CHARACTERS (SLC) 
Instruction Description 
The second operand is subtracted from the first operand 


and the difference is placed in the first-operand 
location. 


Format: SS 
0 Bits 16 20 32 36 47 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a low-order 1 
bit were added to the first operand. 


Overflow and Sign Code: Not applicable. 


Condition code: 


Difference # O, with no carry 
Difference = O, with carry 
Difference # O, with carry 


Wh — © 


Carry: A carry from the high-order bit position is 
recorded in the condition code. 


Boundary Requirements: The operands can overlap if the 
rightmost byte of the first operand is coincident with or 
to the right of the rightmost byte of the second 
operand; otherwise the overlap is destructive and the 
results are unpredictable. 
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Program Exceptions: 


| 
— Address translation J 


— Addressing 
— Effective address overflow 


SLC Example 
Op D,; 
C4 6AO 
0 Bits 16 20 32 36 47 


Assembler: SLC D,(L,, B,), D2 (Bz) 
Machine: C405 3520 46A0 
B, (3): 12C4 1131 1000 


B.(4): 12C4 1133 5000 


Storage — Before 


0/8 2/A 
12C4 1131 1520 1234 5678 
12C4 1133 56A0 | 0000 1234 





Storage — After 


0/8 2/A 
12C4 1131 1520 1234 4444 
12C4 1133 56A0 | 9000 1234 





Before After 


Condition Code: Xx 1 


SUBTRACT LOGICAL HALFWORD (SLH) 
Instruction Description 


The second operand is subtracted from the first operand 


and the difference is placed in the first-operand register. 


Format: RS 


(1 trjole| 
8 12 


0 Bits 16 20 31 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a low-order 1 
bit were added to the first operand. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


Difference # O, with no carry 
Difference = O, with carry 
Difference # O, with carry 


WhO — O 


Carry: A carry from the high-order bit position is 
recorded in the condition code. 


Boundary Requirements: The storage operand must start 
on a halfword boundary; otherwise a specification 
exception occurs and the operation is suppressed. 


Program Exceptions: 


Address translation 
Addressing 

Effective address overflow 
— Specification 


SLH Example 
anno 
91 7 150 
O Bits 8 12 16 20 31 

Assembler: SLH R,, D2(B2) 

Machine: 9130 7150 

B.(7): OABC 0000 1000 
Before After 

R, (3): ABCD 8108 


Condition Code: x 1 


Storage — Before and After 


OABC 0000 1150 


Instruction Descriptions 
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SUBTRACT LOGICAL HALFWORD REGISTER 
(SLHR) 


Instruction Description 


The second operand is subtracted from the first operand 


and the difference is placed in the first-operand register. 


Format: RR 


O Bits 8 12 15 


Operation: The operands are treated as unsigned binary 
quantities. Subtraction is performed as if the ones 
complement of the second operand and a low-order 1 
bit were added to the first operand. 


Overflow and Sign Code: Not applicable. 


Condition Code: 
a) — 
1 Difference # O, with no carry 
2 Difference = O, with carry 
3 Difference # O, with carry 
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Carry: A carry from the high-order bit position is 
recorded in the condition code. 


Boundary Requirements and Program Exceptions: None. 


SLHR Example 


O Bits 8 12 15 
Assembler: SLHR R;,, R2 
Machine: 3134 


Before After 


R, (3): ABCD 8108 
R2 (4): 2AC5 2AC5 
Condition Code: x 1 


J 


SUBTRACT LONG FLOAT (SLF) 
Instruction Description 


The second operand is subtracted from the first operand 
(two-operand format) or the third operand is subtracted 
from the second operand (three-operand format), and 
the result is placed in the first operand location. 


Format: SS 


aie] oo |e) o 


0 Bits 8 12 16 20 32 36 47 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used, if base 
register O is specified for the third operand. A 
three-operand format is used, if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


The exponents of the two operands are compared. The 
significand of the smaller exponent is shifted right as its 
exponent is increased until the exponents are the same. 
The sign bit of the subtrahend (significand of either the 
second operand or the third operand for either 
two-operand or three-operand format respectively) is 
changed. The significands are then added algebraically 
to form the intermediate difference. 


The intermediate difference is rounded, if necessary, 
according to the rounding mode specified in the task 
dispatching element. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
difference. The source operands are checked for this 
value in order of their specification. The masked 
not-a-number with the larger fraction value is provided 
as the difference. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, but its exponent is too large to 
be represented in the result format. See Floating-Point 
Overflow Exception in Chapter 6 for further information. 


A floating-point underflow exception occurs if a result is 
not a normal O and, when examined, is found to have 
too small an exponent to be represented in the result 
format without being denormalized and if the number 
cannot be represented exactly (as a denormalized 
number) or the underflow mask bit is enabled. See 
Floating-Point Underflow Exception in Chapter 6 for 
further information. 


Sign Code: The sign of the difference is determined by 
the rules of algebra. If the difference of two operands 
that have the same sign is O, the sign is made plus for 
all rounding modes except round toward negative 
infinity, where the sign is made minus. 


Condition Code: The difference is compared to O. Values 
of O compare equal even if they differ in sign. 
Not-a-number values and infinite values compare 
unordered. 


Difference = O 
Difference < O 
Difference > O 
Difference is unordered 


WON — Oo 


Carry: Not applicable. 


Boundary Requirements: All operands must be fullword 
aligned; otherwise, a specification exception occurs and 
the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 
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Programming Note: The following chart shows the 
condition of the difference for various operands. : 


ot 
+Real number # 0 
+Real number # 0 
-Real number # 0 
-Real number # 0 
Masked not-a-member 


Masked not-a-number Not not-a-member Masked not-a-number 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operand Unmasked not-a-number 


Invalid operand 


Unmasked not-a-number 


[Invalid operand Ary, 
Invalid operand +|nfinity or -infinity +Infinity or -infinity 


+(nfinity +Real number # O or -real - Infinity J 
number # O 


+\nfinity +Infinity +Real number # O, -real 
number # O, or O 


-Infinity +Real number # 0, -real +|nfinity 
number # 0, or O 


-Infinity -Infinity +Real number #=, -real number 
# 0, or O 
+0 


sot Note 


od Note? 
Legend: 


Not not-a-member = Anthing but a not-a-number 
Any = Any floating-point field value 


Notes: 
1. Value is not rounded toward negative infinity 
2. Value is rounded negative infinity 
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SLF Example 
Op E D. 
CE 2 060 
O Bits 8 12 16 20 32 36 47 
Assembler: SLF D, (B,), D,(B, ), B; 
Machine: CE32 4050 4060 
B3;(3): 0010 0200 0070 
B, (4) and B, (4): 0010 0200 0000 


Storage — Before 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Before After 
Condition Code: x 2 


Instruction Descriptions 
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SUBTRACT PACKED (SP) 
Instruction Description 


The second operand is subtracted from the first operand 
and the difference is placed in the first-operand 
location. 


Format: SS 


pi iutule| oo [e) 
8 12 


0 Bits 16 20 32 36 47 


Operation: Subtraction is algebraic, taking into account 
the signs and all digits of both operands. All digit codes 
are checked for validity. Improper codes cause a data 
exception to be recognized, and the operation is 
terminated. If necessary, zeros are supplied for the 
leftmost bytes of either operand. 


Overflow: Overflow can occur due to the loss of a carry 
from the leftmost digit position of the result field, or due 
to an oversized result, which occurs when the 
second-operand field is larger than the first-operand 
field. Significant digits are lost when an overflow 
occurs. 


Sign Code: The sign codes are checked for validity. 
Improper codes cause a data exception to be 
recognized, and the operation is terminated. The sign of 
the second operand, if negative, is treated as positive, 
and if positive, is treated as negative (this reversal is a 
normal function of subtraction). 


The processor uses the preferred signs for the results as 


follows: a positive sign is encoded as 1111 (hex F); a 
negative sign is encoded as 1101 (hex D). 


10-396 


Condition Code: If an overflow occurs, the condition 
code always indicates the sign the difference would oo 
have had if an overflow had not occurred. 


0 
0 
0 


Difference 
Difference 
Difference 


VA 


WN — O 


Carry: See Overflow 


Boundary Requirements: The first and second-operand 
fields can overlap when their rightmost bytes coincide. 


Because digit and sign codes are checked for validity, 
improperly overlapping fields cause a data exception, 
and the operation is terminated. 


Program Exceptions: 
Address translation 


Addressing 
— Data 


Decimal overflow > 
Effective address overflow 


SP Example 
L,| L, 
7| 3 
O Bit 8 12 16 20 32 36 47 
Assembler: SP D,(L1, Bi), D,(L2, Ba) 
Machine: F173 3100 3104 


B, (3) and B,(3): 0101 0202 3000 


Storage — Before 


0/8 2/A 
0101 0202 3100 1234 5678 





Storage — After 


0/8 2/A 
0101 0202 3100 1234 5678 





Before After 


Condition Code: x 2 


Instruction Descriptions 
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SUBTRACT SHORT FLOAT (SSF) 
Instruction Description 


The second operand is subtracted from the first operand 
(two-operand format) or the third operand is subtracted 
from the second operand (three-operand format), and 
the result is placed in the first operand location. 


Format: SS 


2{e] oo jel oo 


O Bits 8 12 16 20 32 36 4] 


Operation: A two-operand or three-operand format may 
be specified. A two-operand format is used, if base 
register O is specified for the third operand. A 
three-operand format is used, if one of the base 
registers hex 1 through hex F is specified for the third 
operand. 


The exponents of the two operands are compared. The 
significand of the smaller exponent is shifted right as its 
exponent is increased until the exponents are the same. 
The sign bit of the subtrahend (significand of either the 
second operand or the third operand for either a 
two-operand or three-operand format respectively) is 
changed. The significands are then added algebraically 
to form the intermediate difference. 


The intermediate difference is rounded, if necessary, 
according to the rounding mode specified in the task 
dispatching element. 


If a masked not-a-number value is encountered in one 
of the source operands, the operation is completed by 
providing the not-a-number value encountered as the 
difference. The source operands are checked for this 
value in order of their specification. The masked 
not-a-number with the larger fraction value being 
provided as the difference. 


Overflow: A floating-point overflow exception occurs if 
a rounded result is finite, buts its exponent is too large 
to be represented in the result format. See 
Floating-Point Overflow Exception in Chapter 6 for 
further information. 
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A floating-point underflow exception occurs if a result is . 
not a normal O and, when examined, is found to have 2 
too small an exponent to be represented in the result 

format without being denormalized and if the number 

cannot be represented (as a denormalized number) or 

the underflow mask bit is enabled. See Floating-Point 

Underflow Exception in Chapter 6 for further information. 


Sign Code: The sign of the difference is determined by 
the rules of algebra. |f the difference of two operands 
that have the same sign is 0, the sign is made plus for 
all rounding modes except round toward negative 
infinity, where the sign is made minus. 


Condition Code: The difference is compared to 0. Values 
of O compare equal even if they differ in sign. 
Not-a-number values and infinite values compare 


unordered. 
0 Difference = O 
1 Difference < O 
2 Difference > O 
3 Difference is unordered 


Carry: Not applicable. ) 


Boundary Requirements: All operands must be fullword 
aligned; otherwise, a specification exception occurs, and 
the operation is suppressed. 


Program Exceptions: 


— Address translation 

— Addressing 

— Effective address overflow 

— Floating-point inexact result 
— Floating-point invalid operand 
— Floating-point overflow 

— Floating-point underflow 

— Specification 


Programming Note: The following chart shows the 
condition of the difference for various operands. 


a 
po 


+0 +Real number # O +Real number # O 


+Real number #0 +Real number # 0 


+Real number # O +0 or -O -Real number # O 









-Real number # O 


























-Real number # O +0 or -O +Real number # O 


“Real number # 0 -Real number # 0 
Masked not-a-member Masked not-a-number 
Masked not-a-number Masked not-a-number 


Larger masked Masked not-a-number Masked not-a-number 
not-a-number 


Invalid operand Unmasked not-a-number 
Any Unmasked not-a-number 
Invalid operand +Infinity or -infinity +Infinity or -infinity 


+|nfinity +Real number # O or -real 
number # O 
+Infinity +\nfinity +Real number # 0, -real 
number # O, or O 
- Infinity +Real number # O, -real +infinity 
number # O, or O 


- Infinity -Infinity +Real number #=, -real number 
# O, or O 


+0 
*0 
ote 2 


Not not-a-member = Anthing but a not-a-number 


Invalid operand 
















Legend: 


Any = Any floating-point field value 


Notes: 





1. Value is not rounded toward negative infinity 
2. Value is rounded negative infinity 


Instruction Descriptions 
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SSF Example 


Op D, 
AE 060 
12 


0 Bits 8 16 20 32 36 47 
Assembler: SSF D,(B,), D.(B2), Bs 

Machine: AE32 4050 4060 

B3(3): 0010 0200 0070 


B, (4) and B, (4): 0010 0200 0000 


Storage — Before 


2/A 
0010 0200 0050 XXXX 
0010 0200 0060 0000 
0010 0200 0070 0000 





Storage — After 


0010 0200 0050 
0010 0200 0060 
0010 0200 0070 





Before After 
Condition Code: x 1 
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SUPERVISOR EXIT (SVX) 
Instruction Description 


The routine that invoked the current SVL (supervisor 
linkage) is returned to by using the contents of the 
current SVL CRE (call/return element). 


Format: RR 


O Bits 8 12 15 


Operation: The SVX instruction causes the condition 
code, IAR (instruction address register) or CSAR (control 
store address register), and the saved base registers to 
be restored from the first in-use CRE (call/return 
element) on the current TDE (task dispatching element) 
CRE chain (current SVL CRE). The exception code and 
ILC (instruction length count) fields in this CRE are 
ignored. The status of this CRE is then set to available 
(byte 8, bit O of CRE is reset). If the number of available 
CREs encountered before this CRE is equal to or greater 
than the number specified in the control mode field of 
the TDE, the first CRE is returned to the ACQ (available 
call/return queue) via an implicit send. This send causes 
the TDE on the ACQ wait list to be dequeued and 
subsequently enqueued to the TDQ, possibly causing a 
task switch to occur. 


Execution of the SVX instruction may be interrupted by 
1/0. If an 1/O interrupt does occur, the interrupt will be 
processed, and instruction processing will resume at the 
point at which the interrupt was granted. 
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Overflow and Sign Code: Not applicable. 


Condition Code: The code is set to the value saved in 
the CRE. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exception: Specification. 





SVX Example 


O Bits 8 12 15 


Assembler: SVX 
Machine: 3E00 


TDQ 


First TDE Address 
1234 5678 9ABO 


Descriptor 





0 Bytes 2 8 


TDE 


1234 5678 SABO Descriptor Next TDE Address 





0 Bytes 2 8 













Address of CRE 
1234 567F 2A00 





Exception Mask 


CRE 


1234 567F 2A00 Descriptor Next CRE Address 





0 Bytes 2 
Changes to 4 (bit 8 = 0) Available 


Address Register 


C003050 3 0123 Base Register 





8 Bytes C E 
Condition Code (bits 28—31) 


Before After 
Condition Code: x 3 
[AR: XXXX 012 3 
B(Q): XXXX XXXX XXXX CRE bytes E—13 
B(1): XXXX XXXX XXxXX CRE bytes 14—19 
B(2): XXXX XXXX xXxxx CRE bytes 1A—1F 
B(3): XXXX XXXX XXxXxX CRE bytes 20—25 


Instruction Descriptions 


10-403 





SUPERVISOR LINK DOUBLE (SVL2) 
Instruction Description 


The SVL (supervisor linkage) routir selected by the 
index in the I, field of the instruct.on is called using the 
supervisor link mechanism. 


Format: SS 


8 


0 Bits 16 20 32 36 47 


Operation: The index is used to access an entry in the 
SVL table to determine where the SVL routine is located 
and how many registers are to be saved (into an 
available CRE) prior to branching to the routine. 


The effective addresses of the first and second 
operands are computed and checked for an effective 
address overflow exception. No attempt is made to 
access the first or second operands, and they remain 
unchanged in storage. 


An available CRE (call/return element) is found by 
searching the CRE list chained to the current TDE (task 
dispatching element). The current status (IAR 
[instruction address register], condition code, 
identification of the first base register stored, and, the 
number of base registers stored), along with the 
contents of the specified base registers, are stored in 
the last available CRE on the list. If there are no 
available CREs on the list or if the list is empty, a CRE 
is implicitly received from the ACQ and is enqueued first 
on the TDE CRE list. The current status and base 
registers are then stored in that CRE. In either case, the 
status of the CRE obtained is set to in-use (byte 8, bit O 
= 1): 


If it is necessary to obtain a CRE from the ACQ and the 
ACQ is empty, the implicit receive is unsatisfied and the 
SVL instruction is nullified. The TDE of the current task 
is then dequeued from the TDQ and enqueued to the 
ACQ wait list, and the task dispatcher is invoked. 
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saved, the effective address of the first operand is 
placed in base register 1 and the effective address of 
the second operand is placed in base register 2. 


After the registers specified in the SVL table entry are ) 


Execution of the SVL2 instruction may be interrupted by 
1/0. If an |/O interrupt does occur, the interrupt will be 
processed, and instruction processing will resume at the 
point at which the interrupt was granted. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 

Carry: Not applicable. 

Boundary Requirements: None. 


Program Exceptions: 


Descriptor access: Monitored ACQ descriptor 
Descriptor access: Monitored CRE descriptor J 
Descriptor access: Monitored TDE descriptor (SVL 
receive wait) 
Effective address overflow 
Specification 


Programming Notes: If the task dispatcher is disabled 
and an SVL2 instruction is attempted, a machine check 
occurs. An index value of zero is valid, but is also used 
by the processor to signal exceptions. 





C 









SVL2 Example 
0010 0200 1000 Entry Address 
0 Bits 8 16 20 32 36 47 
00 
Assembler: SVL2 D,(B,), D2 (Bz), |s3 pet Olsen Or ov le 


Routine 


Machine: DFnn 3100 4200 1500 


Before After 


VMC Routine 
Not Inhibited 


B(O): 0000 2345 0800 0010 0200 1500! 


B(1): 0101 0101 1110 0123 4567 0100 
Number of Base 


B(2): 0202 0202 2220 0246 8ACE 1200 Registers to Save 
First Base Register 
to Save 


B,(3): 0123 4567 0000 0123 4567 0000 


B2(4): 0246 8ACE 1000 0246 8ACE 1000 
Two-Digit Hex Value 
IAR: 8800 1500 ——_——_—_—_—_—_——— 
1 SID of SVL table address. 
Offset from SVL table entry. 


Control Address Table 







100 0060 | SVL Table Address 0010 0200 1000 
68 | ACO Address 
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TDQ 


First TDE Address J 


Descriptor 
021B 46DC 3900 





0 Bytes 2 8 


TDE 


021B 46DC 3900 Descriptor Next TDE Address 













Address of CRE 
1111 2222 AAAQ 






Bytes E 14 


CRE 


1111 2222 AAAO Descriptor Next CRE Address 





0 Bytes 2 


IAR (value) 








Status 
C0040203 


Bytes r\ C E 
Condition Code 
ILC 


Number of Registers Saved 










Address Register Base Register 


Base Registers O—4 





First Register Saved 


CRE in Use and a VMC Procedure 
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SUPERVISOR LINK MONITORED (SVLM) 
Instruction Description 
This instruction provides for the conditional execution of 


an SVL (supervisor linkage) that is maskable for each 
task. 


Format: RR 


pte 


0 Bits 8 15 


Operation: When the SVL monitored flag (byte hex C, 
bit 7) is reset, this instruction acts as a no-operation. 
When the flag is set, the instruction executes as an 
SVLO using the second SVLM instruction byte as the 
SVL table index. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


Descriptor access: Monitored ACQ descriptor 

Descriptor access: Monitored CRE descriptor 

Descriptor access: Monitored TDE descriptor (SVL 
receive wait) 


Specification 


Programming Note: The processor recognizes a change 
in state of the SVL monitored flag bit only after the 
execution of a Dispatch Task Dispatching Queue 
instruction or after task switch. Thus, if a task sets or 
resets the bit and wants immediate action, it should 
issue a Dispatch Task Dispatching Queue instruction. 


SVLM Example 
Op I 
1F XX 
O Bits 8 15 
Assembler: SVLM | 


Machine: IFxx 


If bit 7 of byte hex C (TDE control mode) is set, this 
instruction executes as an SVLO. See the SVLO instruction 
for further information. 
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SUPERVISOR LINK SHORT (SVLO) 
Instruction Description 


The SVL (supervisor linkage) routine selected by the 
index in the I-field of the instruction is called using the 
supervisor link mechanism. 


Format: RR 


Eire 


O Bits 8 15 


Operation: The index is used to access an entry in the 
SVL table to determine where the SVL routine is located 
and how many registers are saved in an available CRE 
(call/return element) prior to branching to it. 


An available CRE is found by searching the CRE list 
chained to the current TDE (task dispatching element). 
The current status (instruction address register, condition 
code, identification of the first base register stored, and 
the number of base registers stored) and the contents of 
the specified base registers are stored in the last 
available CRE on the list. If there are no available CREs 
on the list or if the list is empty, a CRE is implicitly 
received from the ACQ (available CRE queue) and is 
enqueued first on the TDE CRE list. The current status 
and base registers are then stored in that CRE. In either 
case, the status of the CRE obtained is set to in use 
(byte 8, bit O = 1). 


If it is necessary to obtain a CRE from the ACQ and the 
ACQ is empty, the implicit receive is unsatisfied and the 
SVL instruction is nullified. The TDE of the current task 
is then dequeued from the TDQ (task dispatching queue) 
and enqueued to the ACQ wait list, and the task 
dispatcher is invoked. 
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Execution of the SVLO instruction may be halted due to 
an |/O interrupt. If an |/O interrupt does occur, the 
interrupt will be processed, and instruction processing 
will resume at the point at which the interrupt was 
granted. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


Descriptor access: Monitored ACQ descriptor 

Descriptor access: Monitored CRE descriptor 

Descriptor access: Monitored TDE descriptor (SVL 
receive wait) 


Specification 


Programming Notes: An index value of zero is valid, but 
is also used by the processor to signal exceptions. If 
the task dispatcher is disabled and an SVLO instruction 
is attempted, a machine check will occur. 


C SVLO Example 


0 Bits 8 15 


Assembler: SVLO | 
Machine: 3Fnn 


Control Address Table 


100 0060 SVL Table Address 
68 ACO Address 





SVL Table 








Entry Address 
00 


nn Address of SVL 


Routine 


VMC Routine 
Not Inhibited 


Number of Base 
Registers to Save 


First Base Register 
to Save 


Two-Digit Hex Value 
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TDQ 


First TDE Address 
0000 3ABC 5000 


Descriptor 





0 Bytes 2 8 


TDE 


0000 3ABC 5000 Descriptor Next TDE Address 





0 Bytes 2 8 







Address of CRE 
0000 3BCD A100 






E 14 


CRE 


0000 3BCD A100 Descriptor Next CRE Address 





0 Bytes 2 


AR (value) 




















Address Register 
3320 


Status 
C0040203 








Base Registers 


Cc 











Condition Code Base Registers O—4 


ILC 
Number of Registers Saved 
First Register Saved 


CRE in Use and a VMC Procedure 
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SUPERVISOR LINK SINGLE (SVL1) 
Instruction Description 
The SVL (supervisor linkage) routine selected by the 


index in the I-field of the instruction is called using the 
SVL mechanism. 


Format: Sl 
O Bits 8 16 20 31 


Operation: The index is used to access an entry in the 
SVL table to determine where the SVL routine is located 
and how many registers are to be saved in an available 
CRE (call/return element) prior to branching to the 
routine. 


The effective address of the first operand is computed 
and checked for an effective address overflow 
exception. No attempt is made to access the first 
operand, and it remains unchanged in storage. 


An available CRE is found by searching the CRE list 
chained to the current TDE (task dispatching element). 
The current status (instruction address register, condition 
code, identification of the first base register stored, and 
the number of base registers stored) and the contents of 
the specified base registers are stored in the last 
available CRE on the list. If there are no available CREs 
on the list or if the list is empty, a CRE is implicitly 
received from the ACQ (available call/return element 
queue) and is enqueued first on the TDE CRE list. The 
current status and base registers are then stored in that 
CRE. In either case, the status of the CRE obtained is 
set to in use (byte 8, bit O = 1). 


If it is necessary to obtain a CRE from the ACQ and the 
ACO is empty, the implicit recieve is unsatisfied and the 
SVL instruction is nullified. The TDE of the current task 
is then dequeued from the TDQ and enqueued to the 
ACQ wait list, and the task dispatcher is invoked. 


After the registers specified in the SVL table are saved, 
the effective address of the first operand is placed in 
base register 1. 


Execution of the SVL1 instruction may be interrupted 
due to |/O. If an I/O interrupt does occur, the interrupt 
will be processed, and instruction processing will resume 
at the point at which the interrupt was granted. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Descriptor access: Monitored ACQ descriptor 

— Descriptor access: Monitored CRE descriptor 

— Descriptor access: Monitored TDE descriptor (SVL 
receive wait) 

— Effective address overflow 

— Specification 


Programming Notes: An index value of zero is valid, but 
is also used by the processor to signal exceptions. lf 
the task dispatcher is disabled and an SVL1 instruction 
is attempted, a machine check occurs. 
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SVL1 Example 


O Bits 


8 16 20 31 


Assembler: SVL1D, (B,), |, 


Machine: 5Dnn 3100 


Before After 


XXXX XXXX XXXX 1234 0000 1100 


1234 0000 1000 1234 Q000 1000 


XXXxX  XXXX XXX 1234 0000 1100 


Control Address Table 


100 0060 SVL Table Address 
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68 ACO Address 





SVL Table 








Entry Address 
00 


nn Address of SVL 


Routine 


VMC Routine 
Not Inhibited 


Number of Base 
Registers to Save 


First Base Register 
to Save 


Two-Digit Hex Value 


TDQ 





Descriptor First TDE Address 
OOOB 2427 BBOO 
0 Bytes 2 8 
TDE 
OOOB 2427 BBOO Descriptor 


Next TDE Address 





Address of CRE 
O00B 2431 DBOO 





E Bytes 14 


CRE 


O0OOB 2431 DBOO Descriptor Next CRE Address 





0 Bytes 2 






IAR (value) 












Status Address Register 
C0040203 1473 Base Registers 


Bytes Cc 
Condition Code Base Registers O—4 
ILC 
Number of Registers Saved 


First Register Saved 









CRE in Use and a VMC Procedure 


Instruction Descriptions 10-413 


SUPERVISOR LINK SINGLE MONITORED (SVLM1) 


Instruction Description 


The SVL1 function occurs conditionally, depending on 
the value of a mask bit in the current TDE (task 
dispatching element). 


Format: Sl 
jse | , (al Dp | 
O Bits 8 16 20 31 


Operation: When the SVL1-monitored flag (byte 12, bit 
3 of the TDE) is zero, the instruction acts as a 
no-operation. When the flag is one, an SVL1 occurs 
using the second SVLM1 instruction byte as the SVL 
table index. The index is used to access an entry in the 
SVL table to determine where the SVL routine is located 
and how many registers are to be saved in an available 
CRE (call/return element) prior to branching to the 
routine. 


The effective address of the first operand is computed 
and checked for an effective address overflow 
exception. No attempt is made to access the first 
operand, and it remains unchanged in storage. 


An available CRE is found by searching the CRE list 
chained to the current TDE (task dispatching element). 
The current status (instruction address register, condition 
code, identification of the first base register stored, and 
the number of base registers stored) and the contents of 
the specified base registers are stored in the last 
available CRE on the list. If there are no available CREs 
on the list or if the list is empty, a CRE is implicitly 
received from the ACQ (available call/return element 
queue) and is enqueued first on the TDE CRE list. The 
current status and base registers are then stored in that 
CRE. In either case, the status of the CRE obtained is 
set to in use (byte 8, bit O = 1). 
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If it is necessary to obtain a CRE from the ACO and the 
ACQ is empty, the implicit recieve is unsatisfied and the 
SVL instruction is nullified. The TDE of the current task 
is then dequeued from the TDQ and enqueued to the 
ACO wait list, and the task dispatcher is invoked. 


After the registers specified in the SVL table are saved, 
the effective address of the first operand is placed in 
base register 1. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 


— Descriptor access: Monitored ACQ descriptor 

— Descriptor access: Monitored CRE descriptor 

— Descriptor access: Monitored TDE descriptor (SVL 
receive wait) 

— Effective address overflow 

— Specification 


Programming Notes: The processor recognizes a change 
in state of the bit only after execution of a Dispatch 
Task Dispatching Queue instruction or after a task 
switch. Thus, if a task sets the bit on or off and wants 
immediate action, it should execute a Dispatch Task 
Dispatching Queue instruction. 


An index value of zero is valid, but is also used by the 
processor to signal exceptions. 


If the task dispatcher is disabled and an SVLM1 
instruction is attempted, a machine check occurs. 


SVLM1 Example 

Op 

5B 
O Bits 8 16 20 31 
Assembler: SVLM1 D, (B,), |, 
Machine: 5Bnn 3100 

Before After 

B(O):  xxxxX XXXXK XXXX 1234 0000 1100 


B, (3): 1234 0000 1000 1234 0000 1000 


Control Address Table 


100 0060 SVL Table Address 
68 ACO Address 





SVL Table 








Entry Address 
00 


nn Address of SVL 


Routine 


VMC Routine 
Not Inhibited 


Number of Base 
Registers to Save 


First Base Register 
to Save 


Two-Digit Hex Value 
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TDQ 


Descriptor First TDE Address J 


OOOB 2427 BBOO 





0 Bytes 2 


TDE 


QOOB 2427 BBOO Descriptor Next TDE Address 





Address of CRE 
000B 2431 DBOO 





Bytes E 14 


CRE 


000B 2431 DBOO Descriptor Next CRE Address 





8) Bytes 2 


IAR (value) 












Status 
0c040203 


i Bytes | 


Number of Registers Saved 


Address Register 
1473 









Base Registers 







C 
Condition Code Base Registers O—5 


ILC 


First Register Saved 


CRE in Use anda VMC Procedure 
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TERMINATE IMMEDIATELY (TI) 
Instruction Description 


This instruction causes termination of processing. 


Format: RR 


O Bits 8 12 15 


Operation: The operand register contains the bit patterns 
used by the SCA to activate the light-emitting diodes on 
the CE panel. The TI (terminate immediately) instruction 
causes a machine check when issued if the machine is 
not already in the machine check mode. If already in 
machine check mode, the processor enters check stop 
state. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements and Program Exceptions: None. 





Tl Example 
Op 
OD 
QO Bits 8 12 15 


The codes displayed in CE panel light-emitting diodes 
are related to the first-operand halfword as follows: 


CE Panel 


First- Machine 
Check Light- 


Operand 
Halfword Hex | Sequence 


Indicator 8-15 | Diodes 





Instiuction Descriptions 10-417 


TEST UNDER MASK BYTE IMMEDIATE (TMBI) 
Instruction Description 


The states of the selected first-operand bits are used to 
set the condition code. 


Format: Sl 
O Bits 8 16 20 31 


Operation: The second operand is used as an 8-bit 
mask that corresponds one-for-one with the bits of the 
first operand. A set mask bit indicates that the 
first-operand bit is to be tested. When the mask bit is 
reset, the first-operand bit is ignored. When all bits 
thus selected are reset, condition code zero is set. 
Condition code zero is also set when the mask bits are 
zeros. When the selected bits are ones, the code is set 
to 3; otherwise the code is set to 1. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


O Selected bits are zeros, or 
the mask bits are zeros 
Selected bits are mixed zeros and ones 


NS = 


3 Selected bits are ones 
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Carry: Not applicable. 
Boundary Requirements: None. 


Program Exceptions: 
— Address translation 


— Addressing 
— Effective address overflow 


TMBI Example 


Op L D, 
9D AO 000 


O Bits 8 16 20 31 


Assembler: TMBI D, (B;), Iz 
Machine: 9DAO 3000 


B, (3): 0001 2345 1000 


Storage — Before and After 


0001 2345 1000 


Before After 


Condition Code: x 1 





TEST UNDER MASK BYTE IMMEDIATE AND 
BRANCH IF ONES (TMBIBO) 


Instruction Description 


The states of the selected first-operand bits are used to 
determine if a branch will be taken. 


Format: Sl 


per], jel o | m4 


O Bits 8 16 20 32 47 


Operation: The second operand is used as an 8-bit 
mask that corresponds  Jne-for-one with the bits of the 
first operand. A set mask bit indicates that the 
first-operand bit is to be tested. When the mask bit is 
reset, the first-operand bit is ignored. When all bits 
thus selected are set, the branch is taken. When the 
mask is all zeros, the branch is not taken. 


When a branch is taken, the updated instruction address 
is replaced by the sum of the 16-bit displacement (D,) 


and the offset portion of the instruction stream base 
address contained in base register zero. 


Overflow and Sign Code: Not applicable. 
Condition Code: Not changed. 
Carry: Not applicable. 
Boundary Requirements: None. 
Program Exceptions: 
— Address translation 


-— Addressing 
— Effective address overflow 


TMBIBO Example 


Op D, 
E1 000 


0 Bits 8 16 20 


32 


Assembler: TMBIBO D, (B;), D3, I, 


Machine: E102 3000 OO5E 


B, (3): 0001 2562 1000 


Storage — Before and After 


0001 2562 1000 


Before 
Bo 5425 3111 0122 


IAR 0150 


After 
5425 3111 0122 


0180 


Instruction Descriptions 


47 
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TEST UNDER MASK BYTE IMMEDIATE AND Program Exceptions: 
BRANCH IF ZEROS (TMBIBZ) 
— Address translation 
— Addressing 
Instruction Description — Effective address overflow 


The states of the selected first-operand bits are used to 
determine if a branch will be taken. TMBIBZ Example 


I, D, D, 
Format: Sl AO 000 IFC2 
8 


0 Bits 16 20 32 47 
pecol [al o | 


O Bits 8 16 20 32 47 Assembler: TMBIBZ D,(B,), D;, I, 


Machine: EOQAO 3000 1FC2 
Operation: The second operand is used as an 8-bit 


mask that corresponds one-for-one with the bits, of the B, (3): 0001 2345 1000 
first operand. A set mask bit indicates that the 
first-operand bit is to be tested. When the mask bit is Storage — Before and After 


reset, the first-operand bit is ignored. When all bits 
thus selected are reset, the branch is taken. When the 
mask is all zeros, the branch is taken. 0001 2345 1000 


When a branch is taken, the updated instruction address 
is replaced by the sum of the 16-bit displacement (D,) 
and the offset portion of the instruction stream base 
address contained in base register zero. 





Before After 
By 5432 3210 0020 5432 3210 0020 
Overflow and Sign Code: Not applicable. 
IAR 0130 1FE2 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: None. 
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TEST UNDER MASK BYTE REGISTER (TMBR) 
Instruction Description 


The states of the selected first-operand bits are used to 
set the condition code. 


Format: RR 


O Bits 8 12 15 


Operation: The second operand is used as an 8-bit 
mask that corresponds one-for-one with the bits of the 
first operand. 


A set mask bit indicates that the first-operand bit is to 
be tested. When the mask bit is reset, the first-operand 
bit is ignored. When all bits thus selected are zero, 
condition code zero is set. Condition code zero is also 
set when the mask bits are zeros. When the selected 
bits are ones, the code is set to 3; otherwise the code is 
set to 1. 


Overflow and Sign Code: Not applicable. 


Condition Code: 


0 Selected bits are zeros or 
the mask bits are zeros 

1 Selected bits are mixed 
zeros and ones 


NO 


3 Selected bits are ones 


Carry: Not applicable. 
Boundary Requirements and Program Exceptions: None. 


TMBR Example 

O Bits 8 12 15 
Assembler: TMBRr,,r. 
Machine: 1334 


Before After 


r, (3): 20 20 
ra (4): AO AO 
Condition Code: x 1 
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TRANSLATE (TR) 
Instruction Description 


The 8-bit bytes addressed by the first operand are used 
as arguments to refer to the list of function bytes 
addressed by the second-operand address. Each 8-bit 
function byte selected from the list replaces the 
corresponding argument byte in the first operand. 


Format: SS 
0 Bits 16 20 32 36 47 


Operation: The bytes of the first operand are selected 
one by one for translation, proceeding left to right. Each 
argument byte is added to the initial second-operand 
address. The addition is performed following the rules 
for address arithmetic, with the argument byte treated 
as an 8-bit unsigned integer and extended to the left 
with zeros. The sum is used as the address of the 
function byte, which then replaces the original argument 
byte. The operation proceeds until the entire 
first-operand field is translated. The second operand is 
unchanged by the operation unless the operands overlap 
in storage. 


Execution of the TR instruction may be interrupted due 
to |/O. If an I/O interrupt does occur, the interrupt will 
be processed, and instruction processing will resume at 
the point at which the interrupt was granted. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands may overlap in 
storage. 
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Program Exceptions: 


— Address translation J 


— Addressing 
— Effective address overflow 


Note: The L-field applies only to the first operand. 


TR Example 
Op D, 
cc = 100 
0 Bits 16 20 32 36 47 


Assembler: TR D,(L,,B,),D,(B,) 
Machine: CCO5 32CO 4100 
B, (3): 010A B12C 3000 


B2(4): 010A C34D 2000 


Storage — Before 


0/8 2/A 
010A B12C 32C0 F3F1 F4F1 ) 
010A C34D 2100 


FO 3031 3233 
3839 





Storage — After 


0/8 2/A 
010A B12C 32C0 3331 3431 
010A C34D 2100 


FO 3031 3233 
3839 
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TRANSLATE AND TEST (TRT) 
Instruction Description 
The 8-bit bytes addressed by the first-operand are used 


as arguments to refer to the list of function bytes 
addressed by the second-operand address. 


Format: SS 
.ilel o, [ef o 
O Bits 8 16 20 32 36 47 


Operation: Each function byte selected from the list is 
used to determine the continuation of the operation. 
When the function byte is a zero (that is, hexadecimal 
00), the operation proceeds by fetching and translating 
the next argument byte. When the function byte is 
nonzero, the operation is completed by inserting the 
related argument address into the base register specified 
by B, and then inserting the function byte in byte 
register hex F. 


The bytes of the first operand are selected one by one 
for translation, proceeding from left to right. The first 
and second operands remain unchanged in storage. 
Fetching of the function byte from the list is performed 
as in the Translate instruction. The function byte 
retrieved from the list is inspected for an all-zero 
combination. 


When all the first-operand field is translated before a 
nonzero function byte is encountered, the operation is 
completed by setting condition code zero. The contents 
of the base register specified by B, and byte register 
hex F remain unchanged. 


Condition code 1 is set when one or more argument 


bytes have not been translated. Condition code 2 is set 
if the last selected function byte is nonzero. 
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Overflow and Sign Code: Not applicable. 


Condition Code: 
0 All selected function bytes = 0 
1 Function byte selected # O (before 
the first-operand field is translated) 


2 Last selected function byte # O 
3 ai 


Carry: Not applicable. 


Boundary Requirements: None. 


Program Exceptions: 
— Address translation 
— Addressing 


— Effective address overflow 


Note: The L-field applies only to the first operand. 


TRT Example 

Op L, D, D, 

CD 05 000 000 
0 Bits 8 16 20 32 36 47 
Assembler: TRT D,(L,,B,), D2 (Bz) 


Machine: CD05 3000 4000 


Before After 
B, (3): 010A Bi2C 3000 010A B12C 3000 
B, (4): 010A C34D 2000 010A C34D 2000 
r(15): XX 33 
Condition Code: Xx 1 


Storage — Before and After 


0/8 2/A 4/C 6/E 
010A B12C 3000 F3F1  F4F1  F5F9 
010A C34D 2000 


FO 3031 3233 3435 3637 
3839 
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TRANSLATE REGISTER (TRR) 


Instruction Description 


The 8-bit bytes addressed by the first operand are used 
as arguments to refer to the list of function bytes 
addressed by the second-operand address. Each 8-bit 
function byte selected from the list replaces the 
corresponding argument byte in the first operand. 


Format: SS 
O Bits 16 20 32 36 47 


Operation: The bytes of the first operand are selected 
one by one for translation, proceeding left to right. Each 
argument byte is added to the initial second-operand 
address. The addition is performed following the rules 
for address arithmetic, with the argument byte treated 
as an 8-bit unsigned integer and extended to the left 
with zeros. The sum is used as the address of the 
function byte, which then replaces the original argument 
byte. The operation proceeds until the entire 
first-operand field is translated. The second operand is 
unchanged by the operation unless the operands overlap 
in storage. 


This instruction is identical to the TR instruction except 
the length is specified in a byte register. 

Overflow and Sign Code: Not applicable. 

Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: The operands may overlap in 
storage. 
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Program Exceptions: 


— Address translation 
— Addressing 
— Effective address overflow 


Note: The length specified in the byte register applies 
only to the first operand. 


TRR Example 
Op 
BE 
O Bits 16 20 32 36 47 


Assembler: TRR D,(B,), D2 (Bz), r3 
Machine: BE80 32C0 4100 
B,(3): 010A B12C 3000 
B,(4): 010A C34D 2000 
r3 (8): 05 
Storage — Before | 
, y 
0/8 2/A 4/C 
010A B12C 32C0 F3F1 F4F1 F5F9 
010A C34D 2100 


FO | 3031 3233 3435 
3839 





Storage — After 
0/8 2/A 4/C 


010A B12C 32C0 3331 3431 3539 
010A C34D 2100 
FO 3031 3233 3435 

3839 





TRIM (TRIM) 


Instruction Description 


The trimmed length of the character string located by 
operand 1 is returned in halfword register 15 (R15), 
operand 3. 


Format: Sl 
| 72 |, |el o 
O Bits 8 16 20 31 


Operation: Operand 3 initially contains the untrimmed 

length of the string. A negative value in operand 3 

causes a specification exception. The character value to 

be trimmed is specified by operand 2. 

The operation proceeds as follows: 

i If operand 3 is zero, the instruction is complete. 

2. The character, located by adding the effective 
address of operand 1 to operand 3 and then 
decrementing by one, is compared to |,. If the 


compare is not equal, the instruction is complete. 


3: Operand 3 is decremented by one. Then go to 
step 1. 


If B, is 15, unpredictable results can occur. 


The instruction can be interrupted at any time. 


Overflow and Sign Code: Not applicable. 


Condition Code: Not changed. 


Carry: Not applicable. 


Boundary Requirements: Not applicable. 


Program Exceptions: 


Address translation 


~— Addressing 
— Effective address overflow 
— Specification 
TRIM Example 
Op B, D, 
72 3 2CO 
0 Bits 8 16 20 31 


Assembler: TRIM D,(B,), I, 
Machine: 7240 32C0 


Before After 
B,(3): 101A B12C 3000 101A B12C 3000 


l, : 40 40 


r3 (15): 08 04 


Storage — Before and After 


0/8 2/A 4/C 6/E 
101A B12C 32C0 1020 40FE 4040 4040 
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UNSTACK (UNSTK) 
Instruction Description 


The current stack entry is released and the address of 
the previous stack is loaded into the first operand. 


The UNSTK instruction is used to control the 
deallocation of storage. The storage area is organized 
like a stack. Every storage allocation starts on a 16-byte 
boundary. The maximum size of a storage allocation is 
limited to 64 K-16 bytes. 


Format: RR 


O Bits 8 12 15 


Operation: The first operand initially contains the 
address of the current stack entry. The first 8 bytes of 
the current stack entry contain 4 halfword fields that are 
used by the Stack and Unstack instructions. The first 2 
halfwords are not used by the Unstack instruction. The 
third halfword contains an offset value which, when 
used with the SID (segment identifier) portion of the 
current stack entry address, forms the address of the 
first byte of the previous stack entry. The fourth 
halfword is the flag field. 


Bit position 15 of the fourth halfword in the current 
stack entry (for example, the flag field) is checked. If bit 
15 is set, a stack exception occurs and the operation is 
suppressed. If bit 15 is reset, the contents of the third 
halfword of the current stack entry are loaded into the 
offset portion of the first-operand register, thus making 
the previous entry the new current entry. 
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Overflow and Sign Code: Not applicable. ) 
Condition Code: Not changed. 
Carry: Not applicable. 


Boundary Requirements: Initially the first operand must 
start on a doubleword boundary; otherwise a 
specification exception occurs and the operation is 
suppressed. 


Program Exceptions: 


Address translation 
Addressing 
Specification 

— Stack 


Programming Note: The new current entry is not 
checked for doubleword alignment. 





UNSTK Example 
Op 
2B 
QO Bits 8 12 15 
Assembler: UNSTK B, 
Machine: 2B30 
Before After 


B,(3): 0125 ABAC FOOO 0125 ABAC ECOO 


0125 ABAC ECOO a 


Previous 


0125 ABAC F000 | 


Forward 
Pointer Pointer 
ECOO 
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ZERO AND ADD CHARACTERS (ZAC) 
Instruction Description 


The second operand is placed in the first-operand 
location. 


Format: SS 
6 |ulute! |e] 
O Bits 12 16 20 32 36 47 


Operation: The operation is equivalent to an addition to 
zero with both operands treated as signed binary 
quantities. If the second operand is shorter than the 
first operand, the second operand is considered to be 
extended to the left with bits equal to the sign bit. If 
the first operand is too short to contain all significant 
bits of the second operand, an overflow occurs and only 
the rightmost bits of the second operand are placed in 
the first-operand location. 


Overflow: Not applicable. 


Sign Code: The sign of the result is unpredictable when 
significant bits are lost. 


Condition Code: If an overflow occurs, the code 
indicates the sign the result would have if the first 
operand was long enough to contain all significant bits 
of the result. 


0 Result = 0 
1 Result < 0 
2 Result > 0 
3 cs 


Carry: Not applicable. 
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Boundary Requirements: The operands can overlap in 
storage if the rightmost byte of the first operand is 
coincident with or to the right of the rightmost byte of 
the second operand; otherwise the overlap is destructive 
and the results are unpredictable. 


Program Exceptions: 


Address translation 
Addressing 

Binary overflow 

Effective address overflow 


ZAC Example 
Op D, 
C6 200 
O Bits 12 16 20 32 36 47 


Assembler: ZAC D,(L,,B,),D2(L;,B3) 
Machine: C675 3100 4200 
B, (3): 2102 6100 AOOO 


B,(4): 5718 9420 BoOO 


Storage — Before 


0/8 2/A 
2102 6100 AQOO XXXX XXXX 
5718 9420 BOOO 114A £1188 





Storage — After 


0/8 2/A 
2102 6100 AQ00 0000 114A 
5718 9420 BOOO 114A 118B 





Before After 


Condition Code: x 2 


J 


Appendix A. Teleprocessing Instruction Flow Charts 


These diagrams have been removed from this document. 
See the IBM System/38 Communications Operation 
Charts, SY31-0911, for diagrams showing the 
relationship between segments of the System/38. 


Teleprocessing Instruction Flow Charts A-1 


Appendix B. Operation Code Assignments 


Operation 
Code 
(Second 
Digit) 





2-Byte Instructions 4Byte Instructions 6-Byte Instructions 
Operation Code (First Digit) 


Note 2. ALBR AH ALHR Note 2. AHRI ALHRI Note 1 ALH AHI ALHI AC CBIBE TMBIBZ AP 


R 
SLL SLBR SHR SLHR SLHCT Note 1 Note 1 sc CBIBN TMBIBO SP 
R 


SRL CLBR CH 








CLBRI CHRI CLHRI TRIM CLH CHI CLHI cc cP 
SLA TMBR CLAR ALBRI LA EDPD Note 1 LSOP ALC MP 


SRA LBR LHR EXTAG _MVAST SIC 
LR _LPDEAR INTAG__MVCAT CLC CVPZC cvez 

sce c__cvzr8_cvzPc_cvzr 

FHRF —-FHR RECC STMB STMH STM CVPB 
rNC2 HWA PPR? cvBP 
oc REM cicR MPL? 


XBRI Note 1 SETIT XBIl MVNN- XC DQM CLCL DPL®? 





is) 
v 






> 


z 
oO 


a 
2 
a 


B H 





BR 


H 
















STACK UNSTK SACM = SVLM1 MVBI MVHI MVNZ MVC MVCR MVCL MVPS 


eat ca svt cipl_|Mvaip_MvzN_TR 


Note 1 MVMC CALH SVL1 Note 1 TMBI CSA MVZZ = TRT 


CSH 
BI BR SVX Jc JBN BC EX BCT BCN Note 1 Note 1 Note 1 
SVLM BRL SVLO BAL JBF BU BCNX BALL ALHBL |CSACH CSAC SCAN SVL2 CALLI Note 2 


Notes: 
1. Extended operation code instruction; see Figure B-2 for assignments. 
2. The operation code is reserved and treated as invalid. 





MWS MVPS Z 


= 
x 





s) 
I 
Ym [wh 
is] 
= 
77) 





ERE 







3implicit SVL instructions 





Operation Code Assignment’ B-1 


Operation Code 
Extenders 











2-Byte Instructions 4-Byte Instructions 6-Byte Instructions 
Operation Codes 
wm a wl AE bE ce 


XHRI EQTDE SLB OB AH RRCRR~ SLH CSF AHSPOI CLF 


SETIND DQTDE ALB NB SH LPDEA ASF AHSPO ALF 
RMCM SETCC CLB XB CH LHTEA SSF AFSPO SLF 
STCC OH EPDE MSF TRR MLF 


SETTOD NH _RPDE DSF cvrem —_LF 
RAHR sTTOD XH IPDE CVTMC 





Oo 
ie) 





DTDQ 
DIAG CVSLF! CVTSC CVLSF! 
a es > 
STSOP CVBSF CVBLF 


CVSFPD' CVLIFPD' 


Note: These operation codes are reserved for development testing and will yield unpredictable results if executed. 


CVSFOF' CVLFDF' 
as CVDFSF' cVDFLF! 
CSFMF1! CLFMF1' 


CSFMF2! CLEMF2! 


oe ee es ee ee eee ey 









implicit SVL instructions 





B~2 


Mnemonic 


AC 
AFSPO 


AH 
AHI 
AHR 
AHRI 


AHSPO 


AHSPOI 


ALB 
ALBR 
ALBRI 


ALC 
ALF 
ALH 
ALHBL 


ALHI 


ALHR 


ALHRI 


AP 
ASF 
BAL 
BALL 
BC 


Instruction 


Add Characters 


Add Fullword Space 
Pointer Offset 


Add Halfword 
Add Halfword Immediate 
Add Halfword Register 


Add Halfword Register 
Immediate 


Add Halfword Space 
Pointer Offset 


Add Halfword Space 
Pointer Offset Immediate 


Add Logical Byte 
Add Logical Byte Register 


Add Logical Byte Register 
Immediate 


Add Logical Characters 
Add Long Float 
Add Logical Halfword 


Add Logical Halfword and 
Branch On Limit 


Add Logical Halfword 
Immediate 


Add Logical Halfword 
Register 


Add Logical Halfword 
Register Immediate 


Add Packed 

Add Short Float 
Branch and Link 
Branch and Link Long 


Branch on Condition 


Format 


SS 
SS 


RS 
Sl 
RR 
Rl 


SS 


Sl 


RS 
RR 
Rl 


SS 
SS 
RS 
RS 


S| 


RR 


Rl 


SS 
SS 
Rl 
RS 
Ri 


Operation 
Code 


CO 
BE 


80 
AO 
20 
50 


BE 


BE 


71 
10 
43 


C3 
CE 
90 
OF 


BO 


30 


60 


FO 
AE 
4F 
8F 
6E 
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Extender 


Page 


10-2 
10-4 


10-6 
10-7 
10-8 
10-9 


10-10 


10-12 


10-14 
10-15 
10-16 


10-17 
10-25 
10-18 
10-20 


10-22 


10-23 


10-24 


10-28 
10-29 
10-40 
10-41 
10-43 


Instruction Index 


C-1 


Mnemonic 


BCN 


BCNX 


BCT 
Bl 

BR 
BRL 
BU 
CAL 
CALH 


CALHI 


CALLI 
CBIBE 


CBIBN 


CC 
CH 
CHI 


CHR 


CHRI 


CLAR 


CLB 
CLBI 


CLBR 


CLBRI 


CLC 





Instruction 


Branch on Condition 
Indirect 


Branch on Condition 
Indirect Indexed 


Branch on Count 
Branch Internal 

Branch Register 
Branch Register Long 
Branch Unconditional 
Compute Address Long 


Compute Address Long 
Halfword 


Compute Address Long 
Halfword Immediate 


Call Internal 


Compare Byte Immediate 
and Branch Equal 


Compare Byte Immediate 
and Branch Not Equal 


Compare Characters 
Compare Halfword 


Compare Halfword 
Immediate 


Compare Halfword 
Register 


Compare Halfword 
Register Immediate 


Compare Logical Address 
Register 


Compare Logical Byte 


Compare Logical Byte 
Immediate 


Compare Logical Byte 
Register 


Compare Logical Byte 
Register Immediate 


Compare Logical 
Characters 


Format 


RS 


RS 


Ri 

RR 
RR 
RR 
Rl 

RS 
RS 


Ri 


SI 
Sl 


SI 


SS 
RS 
Sl 


RR 


RI 


RR 


RS 
SI 


RR 


Ri 


Ss 


Operation 
Code 
9E 


7F 


8E 
1E 
2E 
2F 
6F 
4c 
4D 


5C 


EF 
DO 


D1 


C2 
80 
A2 


22 


52 


23 


71 
9C 


12 


42 


C5 


Extender 


Page 


10-44 


10-45 


10-46 
10-42 
10-47 
10-48 
10-49 
10-80 
10-82 


10-82.1 


10-50 
10-54 


10-54.1 


10-54.2 
10-55 
10-56 


10-57 


10-58 


10-59 


10-60 
10-61 


10-62 


10-63 


10-64 





Mnemonic 


CLCL 


CLCR 


CLF 


CLFMF1 


CLFMF2 


CLH 


CLHI 


CLHR 


CLHRI 


CP 
CSA 


CSAC 


CSACH 


CSF 
CSFMF1 


CSFMF2 


CSH 


CVBLF 


CVBP 


Instruction 


Compare Logical 
Characters Long 


Compare Long Character 
Register 


Compare Long Float 


Compute Long Float Math 
Function Using One Input 
Value 


Compute Long Float Math 
Function Using Two Input 
Values 


Compare Logical Halfword 


Compare Logical Halfword 
Immediate 


Compare Logical Halfword 
Register 


Compare Logical Halfword 
Register Immediate 


Compare Packed 


Compute Subscript 
Address 


Compute Subscript 
Address Constrained 


Compute Subscript 
Address Constrained 
Halfword 


Compare Short Float 


Compute Short Float Math 
Function Using One Input 
Value 


Compute Short Float Math 
Function Using Two Input 
Values 


Compare and Swap 
Halfword 


Convert Binary to Long 
Float 


Convert Binary to Packed 


Format 


SS 


Ss 


SS 


SS 


SS 


RS 


Sl 


RR 


RI 


Ss 
Sl 


SS 


SS 


SS 
SS 


SS 


RS 


Ss 


SS 


Operation 


Code 


EA 


E9 


CE 


CE 


CE 


92 


B2 


32 


62 


F2 
AD 


BF 


AF 


AE 
AE 


AE 


7D 


CE 


F8 


Extender 


Page 


10-66 


10-65 


10-72 


10-84 


10-87 


10-68 


10-69 


10-70 


10-71 


10-75 
10-94 


10-96 


10-98 


10-76 
10-90 


10-92 


10-52 


10-100 


10-101 
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C-3 


Mnemonic 


CVBSF 


CVDFLF 


CVDFSF 


CVLFB 


CVLFDF 


CVLFPD 


CVLSF 


CVPB 
CVPDLF 


CVPDSF 


CVPZ 
CVPZC 


CVSFB 


CVSFDF 


CVSFPD 


CVSLF 


CVTCM 


CVTCS 


CVTMC 


Instruction 


Convert Binary to Short 
Float 


Convert Decimal Form to 
Long Float 


Convert Decimal Form to 
Short Float 


Convert Long Float to 
Binary 


Convert Long to Decimal 
Form 


Convert Long Float to 
Packed Decimal 


Convert Long to Short 
Float 


Convert Packed to Binary 


Convert Packed Decimal to 


Long Float 


Convert Packed Decimal to 


Short Float 
Convert Packed to Zone 


Convert Packed to Zoned 
with Data Checking 


Convert Short Float to 
Binary 


Convert Short Float to 
Decimal Form 


Convert Short Float to 
Packed Decimal 


Convert Short to Long 
Float 


Convert Characters to 
MULTI-LEAVING Remote 
Job Entry 


Convert Characters to 
SNA 


Convert MULTI-LEAVING 
Remote Job Entry to 
Character 


Format 


SS 


SS 


SS 


SS 


SS 


SS 


Ss 


SS 
SS 


SS 


SS 
SS 


SS 


SS 


SS 


SS 


SS 


SS 


SS 


Operation 


Code 


AE 


CE 


AE 


CE 


CE 


CE 


CE 


F7 
CE 


AE 


FS 
E5 


AE 


AE 


AE 


AE 


BE 


BE 


Extender 


10-112 


Page 


10-102 


10-118 


10-120 


10-122 


10-124 


10-127 


10-130 


10-140 
10-136 


10-138 


10-141 
10-142 


10-142 


10-144 


10-147 


10-150 


10-103 


10-132 





Mnemonic 


CVTSC 


CVZP 


CVZPB 


CVZPC 


DHS 
DIAG 
DLF 

DP 

DPL 
DQM 
DOTDE 


DSF 
DTD 
DTDQ 


DWS 
EDPD 
EPDE 


EQM 
EQTDE 


ETD 
EX 
EXTAG 
FHR 
FHRF 
FNC2 
GHR 
GHRF 


Instruction 


Convert SNA to 
Characters 


Convert Zoned to Packed 


Convert Zoned to Packed 
with Data Checking and 
Blank Conversion 


Convert Zoned to Packed 
with Data Checking 


Divide Halfword Storage 
Diagnose 

Divide Long Float 
Divide Packed 

Divide Packed Long 
Dequeue Message 


Dequeue Task Dispatching 
Element 


Divide Short Float 
Disable Task Dispatching 


Dispatch Task Dispatching 
Queue 


Divide Word Storage 
Edit Packed Decimal 


Examine Primary Directory 
Entry 


Enqueue Message 


Enqueue Task Dispatching 
Element 


Enable Task Dispatching 
Execute 

Extract Tags 

Free Hold Record 

Free Hold Record First 
Function Call Double 
Grant Hold Record 


Grant Hold Record First 


Format 


SS 


SS 
Ss 


SS 


SS 
Sl 

SS 
Ss 
SS 
SS 
RS 


SS 
RR 
S| 


SS 
RS 
S| 


RS 
RS 


RR 
RS 
Ss 
RS 
RS 
SS 
RS 
RS 


Operation 
Code 


BE 


F6 
D6 


DD 
6D 
CE 
F4 

FA 
DA 
6D 


AE 
OD 
6D 


ED 
63 
83 


6C 
6D 


OD 
7E 
A4 
57 
47 
A8 
56 
46 


Extender 


E6 


Page 


10-152 


10-162 


10-162.1 


10-162.2 


10-171 
10-168 
10-172 
10-176 
10-178 
10-164 
10-166 


10-180 
10-169 
10-170 


10-183 
10-184 
10-198 


10-194 
10-196 


10-192 
10-210 
10-212 
10-214 
10-216 
10-223 
10-228 
10-230 


Instruction Index 


C-5 


Mnemonic 


HVVA 


INTAG 
IPDE 


JBF 
JBN 
Jc 


—- 


LBR 
LBRI 


LH 
LHR 
LHRI 


LHTEA 


LM 
LMB 
LMH 
LPDEA 


LPDEAR 


LR 
LSOP 
LVT 


Instruction 


Hash and Verify Virtual 
Address 


Insert Tags 


Invalidate Primary 
Directory Entry 


Jump on Bits Off 
Jump on Bits On 
Jump on Condition 
Load 

Load Address 
Load Byte 

Load Byte Register 


Load Byte Register 
Immediate 


Load Halfword 
Load Halfword Register 


Load Halfword Register 
Immediate 


Load Hash Table Entry 
Address 


Load Multiple 
Load Multiple Byte 
Load Multiple Halfword 


Load Primary Directory 
Entry Address 


Load Primary Directory 
Entry Address Register 


Load Register 
Load Space Offset Pointer 


Load and Verify Tags 


Format 


SS 


Ss 
Sl 


Rl 
Rl 
Rl 
RS 
RS 
RS 
RR 
Rl 


RS 
RR 
Rl 


RS 


RS 
RS 
RS 
RS 


RR 


RR 
RS 
RS 


Operation 
Code 


D8 


Ad 
83 


5F 
5E 
4E 
94 
53 
74 
14 
44 


84 
24 
54 


83 


95 
75 
85 
83 


25 


15 
93 
64 


Extender 


Page 


10-237 


10-240 
10-242 


10-245 
10-246 
10-248 
10-250 
10-251 
10-255 
10-256 
10-257 


10-258 
10-259 
10-260 


10-261 


10-262 
10-263 
10-264 
10-265 


10-266 


10-267 
10-268 
10-252 


Mnemonic 


MHS 
MLF 
MP 
MPL 
MSF 
MVAST 
MVBI 
MVBIP 


MVC 
MVCAT 
MVCL 
MVCR 
MVHI 
MVMC 
MVNN 
MVNZ 
MVPS 
MVPSZ 
MVZN 
MV2Z 
MWS 
NB 

NBI 
NBR 
NBRI 


NC 
NH 
NHR 
NHRI 


Instruction 


Multiply Halfword Storage 
Multiply Long Float 
Multiply Packed 

Multiply Packed Long 
Multiply Short Float 

Move and Set Tags 

Move Byte Immediate 


Move Byte Immediate and 
Propagate 


Move Characters 

Move Characters and Tags 
Move Characters Long 
Move Character Register 
Move Halfword Immediate 
Move Virtual Page 

Move Numeric to Numeric 
Move Numeric to Zone 
Move Packed Shifted 
Move Packed Shifted Zero 
Move Zone to Numeric 
Move Zone to Zone 
Multiply Word Storage 
AND Byte 

AND Byte Immediate 
AND Byte Register 


AND Byte Register 
Immediate 


AND Characters 
AND Halfword 
AND Halfword Register 


AND Halfword Register 
Immediate 
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SS 
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Sl 

RR 
SS 
SS 
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RS 
Sl 

RR 
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SS 
RS 
RR 
Rl 


Operation 
Code 


DC 
CE 
F3 

F9 

AE 
B4 
9B 
AC 


CB 
B5 
EB 
DB 
AB 
1D 
BA 
BB 
FB 
FC 
BC 
BD 
EC 
79 
98 
18 
48 


C8 
80 
28 
58 


Extender 


Page 


10-286 
10-287 
10-291 
10-292 
10-294 
10-269 
10-270 
10-271 


10-273 
10-274 
10-276 
10-272 
10-278 


10-278.1 


10-279 
10-280 
10-282 
10-284 


10-284.1 


10-285 
10-297 
10-32 
10-33 
10-34 
10-35 


10-36 
10-37 
10-38 
10-39 


Instruction Index 


C-7 


Mnemonic 


OB 
OBI 
OBR 
OBRI 


Oc 
OH 
OHR 
OHRI 


PPR 
RACM 


RAHR 


RCB 
RECC 
RECM 
RMCM 


RPDE 


RRCRR 


SACM 


SC 
SCAN 
SCB 
SENDC 
SENDM 


Instruction 


OR Byte 
OR Byte Immediate 
OR Byte Register 


OR Byte Register 
Immediate 


OR Characters 
OR Halfword 
OR Halfword Register 


OR Halfword Register 
Immediate 


Perform Paging Request 


Reset Address Compare 
Mode 


Return Available Hold 
Record 


Reset Chain Busy 
Receive Count 
Receive Message 


Reset Machine Check 
Mode 


Remove Primary Directory 
Entry 


Read Reference and 
Change and Reset 
Reference 


Set Address Compare 
Mode 


Subtract Characters 
Scan 

Set Chain Busy 
Send Count 


Send Message 





Format 


RS 
Sl 
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SS 
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RS 


RR 
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SS 
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Sl 


S| 


Sl 


SS 
Ss 
RR 
S| 

RS 


Operation 
Code 


79 
99 
19 
49 


C9 
80 
29 
59 


E8 
OD 


OD 


OD 
67 
D9 
OD 


83 


83 


4B 


C1 
CF 
36 
66 
68 


Extender 


Page 


10-298 
10-299 
10-300 
10-301 


10-302 
10-303 
10-304 
10-305 


10-306 
10-320 


10-325 


10-321 
10-312 
10-315 
10-324 


10-319 


10-310 


10-346 


10-384 
10-328 
10-348 
10-334 
10-337 


Mnemonic 


SENDMW 
SETCC 
SETIND 
SETIT 
SETTOD 
SH 

SHR 

SLA 

SLB 

SLBR 


SLC 


SLF 
SLH 
SLHCT 


SLHR 


SLL 
SP 
SRA 
SRL 
SSCA 


SSF 
ST 
STACK 
STB 
STCC 
STH 
STIT 
STM 
STMB 
STMH 
STSOP 


Instruction 


Send Message and Wait 
Set Clock Comparator 

Set Indicator 

Set Interval Timer 

Set Time-Of-Day Clock 
Subtract Halfword 
Subtract Halfword Register 
Shift Left Arithmetic 
Subtract Logical Byte 


Subtract Logical Byte 
Register 


Subtract Logical 
Characters 


Subtract Long Float 
Subtract Logical Halfword 


Shift Left Halfword and 
Count 


Subtract Logical Halfword 
Register 


Shift Left Logical 
Subtract Packed 
Shift Right Arithmetic 
Shift Right Logical 


Store and Set 
Computational Attributes 


Subtract Short Float 
Store 

Stack 

Store Byte 

Store Clock Comparator 
Store Halfword 

Store Interval Timer 
Store Multiple 

Store Multiple Byte 
Store Multiple Halfword 


Store Space Offset Pointer 


Format 
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SS 
RS 
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RS 
RS 
RS 
RS 


Operation 
Code 


69 
6D 
5A 
5A 
6D 
80 
21 

03 
71 

11 


C4 


CE 
91 
61 


31 


01 
F1 
04 
02 
BE 


AE 
96 
1B 
76 
6D 
86 
8C 
97 
77 
87 
83 


Extender 


Page 


10-341 
10-350 
10-352 
10-352 
10-354 
10-386 
10-387 
10-356 
10-388 
10-389 


10-390 


10-393 
10-391 
10-357 


10-392 


10-358 
10-396 
10-359 
10-360 
10-365 


10-398 
10-364 
10-362 
10-370 
10-372 
10-374 
10-376 
10-378 
10-379 
10-380 
10-381 


Instruction Index 


C-9 


Mnemonic 


STST 
STTOD 
SVLM 


SVLM1 


SVLO 
SVL1 
SVL2 
SVX 
TI 
TMBI 


TMBIBO 


TMBIBZ 


TMBR 


TR 
TRIM 
TRR 
TRT 


UNSTK 
XB 


XBI 


XBR 
XBRI 


XC 
XH 
XHR 


XHRI 


ZAC 





Instruction 


Store and Set Tags 
Store Time-Of-Day Clock 


Supervisor Link Monitored 


Supervisor Link Single 
Monitored 


Supervisor Link Short 
Supervisor Link Single 
Supervisor Link Double 
Supervisor Exit 
Terminate Immediately 


Test Under Mask Byte 
Immediate 


Test Under Mask Byte 
Immediate and Branch If 
Ones 


Test Under Mask Byte 
Immediate and Branch If 
Zeros 


Test Under Mask Byte 
Register 


Translate 

Trim 

Translate Register 
Translate and Test 
Unstack 

Exclusive OR Byte 


Exclusive OR Byte 
Immediate 


Exclusive OR Byte Register 


Exclusive OR Byte Register 
Immediate 


Exclusive OR Characters 
Exclusive OR Halfword 


Exclusive OR Halfword 
Register 


Exclusive OR Halfword 
Register Immediate 


Zero and Add Characters 


Format 
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Sl 


RR 


SS 
SI 

SS 
SS 
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RS 
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Ss 
RS 
RR 


Rl 


SS 


Operation 
Code 


65 
6D 
1F 
5B 


3F 
5D 
DF 
3E 
OD 
9D 


E1 


EO 


13 


CC 
72 
8E 
CD 
2B 
79 
9A 


4A 


CA 
80 
2A 


5A 


C6 


Extender 


Page 


10-368 
10-382 
10-407 
10-414 


10-408 
10-411 
10-404 
10-402 
10-417 
10-418 


10-419 


10-420 


10-421 


10-422 
10-417 
10-426 
10-424 
10-428 
10-201 
10-202 


10-203 
10-204 


10-205 
10-206 
10-207 


10-208 


10-430 


<: Less than. 


>: Greater than. 


IV 


: Greater than or equal to. 


=: The value to the left of the symbol is the same as the 
value to the right of the symbol. 


#: The value to the left of the symbol is not the same as 
the value to the right of the symbol. 


ACQ: Available CRE queue. 

active task: The task that is currently executing. 

address compare mode: The condition of the machine when 
an address compare exception can occur if a storage 
location is either referenced, accessed, or altered. 

address event: An I/O event stack entry type that indicates 
that a page boundary crossing occurred during the 
modification of a resolved virtual address contained in an 
I/O address register. 

address list element (ALE): An 8-byte IMP object 
containing a virtual or virtual=real address to be used 
during page chaining operations. 

address operation block (AOB): One of the five forms of 
the operation block that is used to save, modify, or load the 


I/O address registers during an operation. 


address register (AR): A register in which an address is 
stored. 


AHR: Available hold record. 

ALE: Address list element. 

ALU: Arithmetic and logic unit. 

ANSI: American National Standards Institute. 
AOB: Address operation block. 


AR: Address register. 


Appendix D. Glossary 


argument: (1) (ISO) An independent variable. (2) (ISO) 
Any value of an independent variable. 


arithmetic and logic unit (ALU): The part of a computer that 
performs arithmetic, logic, and related operations. 


asynchronous: (1) Without regular time relationship. (2) 
Unexpected or unpredictable with respect to the execution 
of a program’s instruction. 


available CRE queue (ACQ): The mechanism by which 
CREs (call/return elements) are made available to the 
processor and eventually to a TDE (task dispatching 
element). 


available hold record (AHR): An unused hold record. 


B.: A 6-byte base register represented by B is used as 
operand X. 


base: The number system in which an arithmetic value is 
represented. 


base register (B): The register that contains the address of 
the start of the instruction stream. 


basic status (BSTAT): Two bytes of adapter response data 
reported by the channel to the I/O event stack. 


bias: In binary floating-point storage formats, the constant 
value that, when added to the signed exponent of a binary 
floating-point number, produces a non-negative biased 
exponent. The bias for short format is 127 and for long 
format is 1023. 


biased exponent: (1) In binary floating-point storage 
formats, the non-negative sum of the signed exponent of a 
binary floating-point number and a constant value (bias). 
(2) The value between the maximum and minimum field 
values that is used to represent the signed exponent of a 
normalized binary floating-point number. The range of 
biased exponent values is 1 through 254 for the short 
format and 1 through 2046 for the long format. Contrast 
with signed exponent. 


BID: Byte identifier. 
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binary digits: The numbers 0 and | that are used to 
represent a value in the numbering system that has 2 as its 
base. 


binary floating-point number: A conceptual representation of 
a numerical value that contains a signed significand and a 
signed exponent. Its numerical value is the signed product 
of its significand and 2 raised to the power of its exponent. 
Contrast with long format and short format which are used 
to represent binary floating-point numbers in storage. A 
binary floating-point number is either a normalized number, 
a denormalized number, or a signed zero. 


binary floating-point value: One of the set of values 
supported for binary floating-point operations. The set of 
values supported is composed of binary floating-point 
numbers, infinity, and not-a-number. 


binary point: The point that separates the integer digits from 
the fraction digits in the numbering system that has 2 as its 
base, similar to decimal point. 


branching instructions: Instructions that may change the 
sequence of program execution. 


BSTAT: Basic status. 


built-in function: A well defined HMC (horizontal 
microcode) operation that is used to enhance the 
performance of the processor. 


byte: A group of 8 adjacent bits that a computer processes 
as a unit. 


byte identifier (BID): Bits 39-47 of a virtual address. The 
portion of a virtual address that identifies the specific byte 
of data addressed within a page. 


call/return element (CRE): A resident storage area used to 
save the status of a procedure during an SVL (supervisor 
linkage). 


chain: Two or more objects linked together. 


chaining: A system of storing records in which each record 
belongs to a list or group of records and has a linking field 
for tracing the chain. 


channel interface: The interface between the vertical 
microcode I/O manager tasks responsible for I/O and 
operational unit tasks that handle I/O operations. 


command end: A function event used by an I/O device to 
communicate error or exception status to the device I/O 
manager task. 


comparison instructions: Instructions that are designed to 
test the relationship between items of data. 


completed: A term used to describe an action that the 
system may take when an exception occurs during the 
execution of an instruction. The instruction is allowed to 
continue to completion with predictable results and the IAR 
is advanced to the next instruction address. The ILC 
indicates the length of the completed instruction. 


concatenate: To link together two or more operands. 
concurrent: (1) (ISO) Pertaining to the occurrence of two 
or more activities within a given interval of time. (2) 
Contrast with consecutive, sequential, simultaneous. 
condition code: A 4-bit code that reflects the results of 
most of the arithmetic, logical, and other manipulative and 
control instructions. 

control address table: The assigned storage location for 
certain control information that must be known to the 
processor to execute IMP (internal microprogramming) 
tasks. 

control storage: The storage in which HMC is loaded. 
control storage address register (CSAR): The address register 
used by the HMC (horizontal microcode) to control 
command sequencing. 


CPU: Processing unit. 


CPU cluster: The planer board, array board, interposers, 
main end control storage cards, and the terminators. 


CRE: Call/return element. 
CSAR: Control storage address register. 


D,: The displacement represented by D is used with 
operand X. 


dequeue: To remove items from a queue. 


data field length: The number of bytes of data in the source 
data field. 


J 


denormalized number: In binary floating-point storage 
formats, the representation of a nonzero number in which 
the exponent field contains a reserved value (0) at the 
format’s minimum and the fraction field is greater than 0. 
The significand of the number represented has an integer 
value of 0, which is implied by the storage representation 
and a fraction value from the fraction field. The reserved 
value of O in the exponent field indicates the value of the 
signed exponent (power of 2) is decimal -126 for the short 
format and decimal -1022 for the long format. 


dequeue: To remove items from a queue. 


descriptor: That portion of an IMP (internal 
microprogramming) object that is used as a unique 
identifier. 


destination: See result field. 


device status (DSTAT): The bytes of information required 
for proper device maintenance. 


displacement: (1) The distance from the beginning of a 
record, block, or segment to the beginning of a particular 
field. (2) Synonym for relative address. 


DSTAT: Device status. 

E: Operation code extender field. 

EBCDIC: Extended binary coded decimal interchange code. 
enqueue: To place items on a queue. 


error event: An I/O event stack entry type that indicates 
error conditions involving the channel hardware. These 
errors are handled by IMP (internal microprogramming) 
channel error microcode. 


error recovery procedure: A set of instructions designed to 
help isolate and, where possible, recover from errors in 
equipment. These instructions are often used with programs 
that record the statistics of machine malfunctions. 


event handler: A program, specified in an event monitor, 
that is to receive control when the event occurs. 


event stack: A list of 4-byte entries that contain function, 
address, or error events. The entries are placed on the list 
by the channel liardware and are removed from the list by 
the I/O event handler. 


exception: The occurrence of a monitorable machine or 
user-defined condition directly associated with the execution 
of a particular function within a program. Exceptions 
generally represent an abnormality detected by the machine 
or by a program. Exceptions are signaled to a single 
monitor within the associated process. 


explicit designation: Designation by the use of information 
contained within an operand of an instruction. 


explicit invocation: Causing a procedure to wait by the use 
of an IMP (internal microprogramming) instruction. 


explicit length: Length of an instruction as stated within the 
instruction. 


exponent range: In binary floating-point storage formats, 
the set of integer exponents that can be represented in a 
particular format. The representable signed exponent range 
is decimal -126 through +127 for short format and decimal 
-1022 through +1023 for long format. 


extender (E): A 4-bit extension of the IMP operation code. 
FIB: Fill instruction buffer. 


field replaceable unit: An assembly that is replaced in its 
entirety when any one of its components fails. 


fill instruction buffer (FIB): An HMC (horizontal 
microcode) status control to fill the instruction stream 
buffer. 


floating-point format: In binary floating-point representation 
the storage format used to represent a binary floating-point 
value. See long format and short format. 


FOB: Function operation block. 


format’s maximum: In binary floating-point storage formats, 
the value of 255 (short format) or 2037 (long format) in 
the exponent field. This value indicates that either a signed 
infinity (fraction equals 0) or a not-a-number (fraction does 
not equal 0) is represented in the storage format. 


format’s minimum: In binary floating-point storage formats, 
the value of zero in the exponent field. This value indicates 
that either a zero floating-point value (fraction equals 0) or 


a denormalized number (fraction does not equal 0). 


fraction: In binary floating-point representation, the value 
to the right of the binary point. 


FRAT: Function routine address table. 
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free: To unlock a system or data base object. 
FSTAT: Functional status. 


function event: An I/O event stack entry type that 
communicates device or IMP (internal microprogramming) 
task request to an operational unit task. 


function operation block (FOB): One of five forms of the 
operation block that identify the operational unit and 
convey the command to be executed by the operational 
unit. 


function routine address table (FRAT): An indexed table of 
addresses to instruction streams that perform specific tasks. 


functional status (FSTAT): One of 4 bytes of operational 
unit information that can be required by the program for 


normal device operation. 


gap length: The number of bytes of data between fields in 
the source operand. 


gap offset: The number of bytes to the next gap in the 
source. 


preater than (>): The value to the left of the symbol is 
greater than the value to the right of the symbol. 


halfword: 16 bits or 2 bytes on an integral boundary. 
hash hold table (HHT): A storage page which contains 
halfword entries, that are used as an index (after being 


manipulated) into the hold record area. 


hash synonyms: Equal hash values that are obtained by 
hashing different object addresses. 


hashing: The compression of the 39-bit field formed by 
linking the segment and page identifier fields of a virtual 
address. 

HHT: Hash hold table. 

HMC: Horizontal microcode. 


hold: A lock on a given system or data base object. 


hold record (HR): A record of information describing the 
constraints that have been imposed on the use of an object. 


hold record area: A virtual addressing segment that contains 
all object chains of HRs. 
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horizontal microcode (HMC): Microcode that exhibits a high 
degree of parallelism of execution, controls the detailed > 
state of the hardware, and supports the IMP (internal 

microprogramming) instruction set. 


HR: Hold record. 


I: The immediate data represented by I is used as operand 
X in the instruction in which it appears. 


I/O manager queue (IOMQ): An IMP send/receive queue 
used to communicate I/O command response information to 
an I/O manager task from a device operationa! unit task. 


I/O register table: A table containing pointers to the queue 
control table. It is accessed by using the operational unit as 
an index. 


IAR: Instruction address register. 
ILC: Instruction length count. 


immediate data operand: An operand that contains the data 
attributes and the data in the instruction. 


IMP: Internal microprogramming. 


IMP objects: A separately addressable unit (or collection or J 
data) that has associated attributes as well as operating 
characteristics based on these attributes. 


IMPL: Initial microprogram load. 


implicit designation: Designation by the use of the operation 
code as an index into a storage table. 


implicit invocation: Causing a procedure to wait by the use 
of an HMC (horizontal microcode) procedure. 


implicit leading bit: A bit that does not appear in the storage 
form of a binary floating-point number. This bit is 
understood to be to the left of the assumed binary point. 
See significand. 


implied length: The length of the instruction as recognized 
by the specific operation code being used. 


inexact result: A result that occurs when bits of the 
significand are lost in rounding the intermediate result to 
the precision of the result field or when infinity is stored as 
the result of a masked overflow. 


infinity: In binary floating-point operation, a name for the 
values beyond the minimum and maximum finite values that 
can be represented. These finite values are represented in 
the storage formats when the exponent field contains a 
reserved value (255 for short format and 2047 for long 


format) at the formats’ maximum and the fraction field is 0. 


Infinity can be positive or negative. 


infinity arithmetic: The adding, subtracting, multiplying, 
dividing, and comparing of values that are beyond the 
minimum and maximum values that can be represented as 
finite values in the binary floating-point format. 


initial microprogram load (IMPL): The initiation of 
processing when the contents of storage are not suitable for 
processing. 


initial program load (IPL): The initialization procedure that 
causes an operating system to Start operations. 


input/output: In System/38 the name given the 
microprocessor used in the attachment of various I/O 
devices. 


input/output controller (IOC): (ISO) A functional unit in a 
data processing system that controls one or more units of 
peripheral equipment. 


input/output manager (IOM): A VMC (vertical microcode) 
programming object that controls the flow of information 
(control and [I/O data) to and from an I/O unit. 


instruction address register (IAR): (ISO) A register from 
whose contents the address of the next instruction is 
derived. 


instruction length count (ILC): A 3-bit code that provides 
the length of the last instruction executed. 


integral boundary: A location in main storage at which a 
fixed-length field, such as a halfword or doubleword, must 
be positioned. The address of an integral boundary is a 
multiple of the length of the field, in bytes. 


intermediate denormalized floating-point number: In binary 
floating-point operation, an intermediate unrounded form of 
the result in which a value that is too small to be 
represented in the floating-point format of the result has 
had the significand digits shifted right (zeros are supplied 
on the left) and the exponent incremented until the 
exponent attains the format’s assumed value for 
denormalized numbers (-126 for a short format and -1022 
for long format). 


intermediate result: In floating-point operations, the 
normalized result produced prior to the adjustments 
required to store it in the result field. 


interval timer: A means of measuring elapsed time and 
determining when a prespecified amount of time has 
elapsed. 


invocation: An invocation is the execution of a program. It 
represents the status of the process after the program is 
invoked. When one programs calls another program, the 
two programs are said to be in different invocations. The 
invocation of a program that is called a second time by the 
same calling invocation is also considered to be a different 
invocation. Automatic storage is allocated for a program at 
every invocation. 


IOC: Input/output controller. 

IOM: Input/output manager. 

IOMQ: I/O manager queue. 

ISO: International Organization for Standardization. 
J.. Jump displacement. 

jump displacement (J): The number of bytes (address 


increments) added to the instruction address after a jump 
instruction is executed. 


L,: The length of the operand represented by L is used as 
operand X in the instruction in which it appears. 


LB: Lookaside buffer. 
LOB: Loop operation block. 


local storage register (LSR): A register that is assigned to 
hold processor information. 


long format: In binary floating-point operations, the storage 
representation of a binary floating-point number, a 
not-a-number, or infinity. The long format is a 64-bit string 
in which bit 0 is the sign field, bits 1 through «+ are the 
11-bit exponent field, and bits 12 through 63 are the 52-bit 
fraction field. Contrast with binary floating-point number 
which is the conceptual view of the number. 


lookaside buffer (LB): A separate hardware storage array 


used to store recently translated virtual addresses along with 
their corresponding real addresses. 
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loop operation block (LOB): One of the five forms of the 
operation block that allows an operation program to contain 
a loop for efficient operation. 


LSR: Local storage register. 


M_,: The mask represented by M is specified for operand X. 


machine check (MCHK): A detected machine malfunction 
that can occur in hardware or HMC. 


machine check log buffer (MCLB): A data area in virtual 
storage used to store the processor status and the task 
status when a machine check occurs. 

machine communications area (MCA): The assigned storage 
locations, which contain control information required for 
VMC objects to communicate with each other. 

machine interface (MI): The instruction set interface to the 
machine. The instruction set is called the System/38 
instruction set. 

main storage: See real storage. 

MCA: Machine communications area. 

MCHK: Machine check. 

MCLB: Machine check log buffer. 

message operation block (MOB): One of the five forms of 
the operation block that either sends a message to a queue 
or increments a counter. 


MI: Machine interface. 


microcode: The instructions providing the basic machine 
functions and supporting the machine interface. 


MOB: Message operation block. 

monitor: A process that checks for the occurrence of an 
event or exception and takes action based on that event or 
exception. 

MSAR: Main storage address register. 


NaN: See not-a-number. 


negative infinity: See infinity. 
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normalized number: In binary floating-point storage formats, 
the representation of a nonzero floating-point number 
whose exponent field contains a biased exponent. The 
range of biased exponent values is 1 through 254 for the 
short format and 1 through 2046 for the long format. The 
significand of the number represented has an integer value 
of 1 and a fraction value from the fraction field. Note that 
the exponent field values of 0 and 255 for the short format 
and 0 and 2047 for the long format are used to indicate the 
representations of infinity, not-a-number, denormalized 
number, and signed 0. 


no-operation: No operation is performed. The JAR is 
updated to the next sequential instruction. 


not-a-number: In binary floating-point storage formats, the 
name for a value that is not interpreted as a number. A 
not-a-number (NaN) is represented by an exponent field 
that contains a reserved value at the format’s maximum 
(255 for short format and 2047 for long format) and a 
fraction field that does not contain 0. A not-a-number may 
represent the results of incorrect combinations of operands 
in floating-point operations. 


nullified: A term used to describe the action the system may 
take when an exception occurs during the execution of an 
instruction. The instruction is stopped with the JAR not 
advanced to the next instruction address. The ILC is set to 
zero. 


OB: Operation block. 


object: A separately addressable unit that has associated 
with it certain attributes as well as operational 
characteristics based on these attributes. 


offset: The distance from the beginning of a register or 
record to the beginning of a particular field. 


op code: Operation code. 


operation block (OB): The portion of the ORE (operation 
request element) that contains operation unit information. 
The five types of operation blocks are: address operation 
block, function operation block, loop operation block, 
message operation block, and program operation block. 


operation code: An 8-bit code which specifies the operation 
to be performed by the IMP instruction to which the code 
is unique. 


operation program (OP): A set of operation blocks placed in 
storage and executed together prior to any response. 


2 


2 


operation request element (ORE): An IMP (internal 
microprogramming) message, placed on an operational unit 
queue, to cause an I/O operation. It consists of a standard 
IMP queue element header, a status field, and an operation 
block. 


operational unit (OU): An I/O device or source of 
asynchronous events together with an OU task that controls 
the device or the event. 


operational unit number: A 1-byte number that uniquely 
defines an operational unit and is used as an index into the 
operational unit table to locate the queue control table. 


operational unit queue (QUQ): The queue upon which 
OREs (operation request elements) are placed by the 
source/sink component below MI (machine interface). 
There is one operational unit queue for each operational 
unit. 


operational unit task: A microcode task that exists for each 
operational unit that performs operations such as operation 
block execution and command completion functions. The 
operational unit task services the operational unit queue and 
I/O events. 


ORE: Operation request element. 
OU: Operational unit. 
OUQ: Operational unit queue. 


page: (1) (ISO) In a virtual storage system, a fixed-length 
block that has a virtual address and that can be transferred 
between real storage and auxiliary storage. (2) *A block of 
instruction, or data, or both, that can be located in main 
storage or in auxiliary storage. Segmentation and loading of 
these blocks is automatically controlled by a computer. (3) 
To transfer instructions, or data, or both between real 
storage and external page storage. (4) In System/38 a page 
contains 512 bytes. 


page fault: In a virtual storage system, a program exception 
that occurs when a page that is not in main storage is 


referred to by an active task. 


page frame: In a virtual storage system, a 512-byte block of 
main storage that can contain a page. 


page identifier (PID): Bits 32 through 38 of a virtual 
address. 


PD: Primary directory. 


PEM: Program event monitor. 


permanent storage assignments: The assignments of storage 
locations contained within the control address table. 


PID: Page identifier. 


pin count (PINCNT): A counter that records the number of 
times a page of storage is pinned while the page is in 
storage. The pin count is used for holding pages in storage. 


PINCNT: Pin count. 
pinning: A mechanism used to hold pages in storage. 


placeholder: A symbol that may be replaced by some other 
value. 


PMCH: Processor machine check handler. 
POB: Program operation block. 
positive infinity: See infinity. 


preempt wait: A task switch that occurs if a TDE is 
enqueued to the TDQ at a higher priority than the current 
TDE. 


primary directory (PD): A list of entries in which each entry 
contains the virtual address and the status of a page frame 
in main Storage. 


procedure: (1) *(ISO) The course of action taken for the 
solution of a problem. (2) *The description of the course 
of action taken for the solution of a problem. 


processing unit (CPU): The unit of the computer that 
includes circuits controiling the interpretation and execution 
of instructions. 


processor machine check handler (PMCH): An HMC 
(horizontal microcode) routine that attempts to recover 
from apparent machine malfunctions. 


program event monitor (PEM): The processor comparing the 
initial byte of the instructions to determine if they fall 
within the range of the PEM start and PEM stop addresses. 


program operation block (POB): One of five forms of the 
operation block that is used in an operation request element 


when an operation program is to be executed. 


QCT: Queue control table. 
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quadword: A group of 4 consecutive words located at an 
integral boundary. 


queue: (1) A line or list formed by items in a system 
waiting for service, for example, tasks to be performed or 
messages to be transmitted in a message switching system. 
(2) A system object to which a list or line of items are 
related while waiting for service. 


queue control table (QCT): A table, accessed by microcode 
and machine product code, that controls I/O operations. 
There is one table for each operational unit. 


r,: A one-byte register represented by r is used as operand 
X. 


R,: A halfword register represented by R is used as 
operand X. 


RAR: Resolved address register. 


real storage: (1) (ISO) The main storage in a virtual storage 
system. Physically, real storage and main storage are 
identical. Conceptually however, real storage represents 
only part of the range of addresses available to the user of 
a virtual storage system. Traditionally, the total range of 
addresses available to the user was that provided by main 
storage. (2) Same as processor storage. 


reserved values: In binary floating-point representation, the 
exponent field values of 0 and 255 for the short format and 
0 and 2047 for the long format that are used to indicate 
representations of infinity, not-anumber, denormalized 
number, and 0. 


resolved address: A translated virtual address. 


result offset: The number of bytes of the result field that 
are to be processed (upon entry to the instruction). 


RI: An instruction type that uses register and immediate 
operand parameters. 


rotary switches: Those console switches that are used to 
control the basic machine functions. 


rounding: In binary floating-point operations, a modification 
of a value, if necessary, so that it is representable in the 
format of the result field. An inexact result exception 
condition may occur due to rounding. 
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rounding to nearest: In floating-point operations, to modify 
a value to the nearest representable value. However, if the J 
value of those digits being dropped is exactly half of the 

least significant digit of the retained value, the nearest 

representable value in which the least significant digit is 

even is chosen. 


round toward negative infinity: In floating-point operations, a 
modification of a value to the representable value that is 
closest to but no greater than the unmodified value. The 
result may be negative infinity. 


round toward positive infinity: In floating-point operations, a 
modification of a value to the representable value that is 
closest to but not less than the unmodified value. The result 
may be positive infinity. 


round toward zero: In floating-point operations, a 
modification of a value to the representable value that is 
closest to and no greater in absolute value than the 
unmodified value. The result may be 0. 


RR: An instruction type that uses only register operands. 


RS: An instruction type that uses register and storage 
operand parameters. 


S: A 4-byte register represented by S is used as operand. J 
SCA: System control adapter. 


scalar: *(1) (ISO) A quantity characterized by a single 
number. (2) Contrast with vector. 


SDR: Statistical data recording. 


segment: A unique, continuous area of virtual storage. 
Segments are nonoverlapping and noncontinuous with each 
other. 


segment identifier (SID): Bits 0 through 31 of a virtual 
address. 


send/receive counter (SRC): The IMP (internal 
microprogramming) instruction object used to exchange 
intertask information and to synchronize the flow of control 
between tasks; a count field used for control but no 
messages are enqueued. 


send/receive message (SRM): An IMP (internal 
microprogramming) instruction object that contains a 
message and may be enqueued to an SRQ (send/receive 


queue). F 


send/receive queue (SRQ): An IMP (internal 
microprogramming) instruction object that is used to 
exchange intertask information to synchronize the flow of 
control between tasks. 


set: (1) (ISO) To put all or part of a data processing device 
into a specified state. (2) Contrast with reset. 


short format: In binary floating-point operations, the 
storage representation of a binary floating-point number, 
not-a-number, or infinity. The short format is a 32-bit 
string in which bit 0 is the sign field, bits 1 through 8 are 
the 8-bit exponent field, and bits 9 through 31 are the 
23-bit fraction field. See also binary floating-point number. 


SI: An instruction type that uses storage and immediate 
operand parameters. 


SID: Segment identifier. 


signed exponent: In floating-point operations, the arithmetic 
representation of the exponent value of the floating-point 
number. 


signed zero: In binary floating-point formats, the 
representation of the number 0 whose exponent field 
contains a reserved value at the format’s minimum and a 
fraction field that is equal to 0. Zero can be positive or 
negative; however, positive 0 for denormalized numbers and 
1 for normalized numbers. 


significand: In binary floating-point operations, the part of a 
binary floating-point number that is composed of binary 
digits which contain integers to the left of a binary point 
and one or more fraction digits to the right. The value of 
the integer is implied by the storage representation of a 
binary floating-point number. The value of the integer digit 
is 0 for denormalized numbers and 1 for normalized 
numbers. 


source/sink: Pertaining to devices capable of originating or 
accepting data signals to or from a transmission device 
(such as a central processor) and pertaining to the data 
management components supporting such devices. 
Source/sink devices include locally and remotely attached, 
batch and work station devices, but not the internal storage 
of the system. 


source offset: The number of bytes of the source field that 
are to be processed (upon entry to the instruction). 


source operand: The operand that contains the source as 
provided by the user of a data processing system. 





source record length: The number of bytes of data in a 
source record as provided by the user. 


SRC: Send/receive counter. 
SRM: Send/receive message. 
SRQ: Send/receive queue. 


SS: An instruction type that uses only. storage operands for 
parameters. 


stack: (1) (ISO) A list that is constructed and maintained 
so that the next item to be retrieved and removed is the 
most recently stored item still in the list, that is, last in-first 
out. Synonymous with pushdown list. 


Statistical data recording (SDR): Statistical information for 
each I/O device on the system stored in auxiliary storage 
by VMC. 


storage capacity: The number of bytes provided without 
regard to the storage width. 


storage width: The number of bytes that can be fetched or 
stored in one storage cycle. 


string: *(1) (ISO) A linear sequence of entities such as 
characters or physical elements. 


supervisor linkage (SVL): The method by which IMP 
(internal microprogramming) procedure switching is 
accomplished within a task and the method by which IMP 
exceptions are reported. 


suppressed: A term used to describe the action the system 
may take when an exception occurs during the execution of 
an instruction. The instruction is not allowed to continue 
and the IAR is advanced to the next instruction address. 
The result fields are not changed. The ILC indicates the 
length of the suppressed instruction. 


suspended: A term used to describe the action the system 
may take when an exception occurs during the execution of 
an instruction. The instruction is stopped at the point of the 
exception and checkpoint data is stored in a reserved area. 
The IAR is not advanced to the next instruction address so 
that the operation can be resumed at the point of the 
exception. The ILC is set to zero. 


SVL: Supervisor linkage. 
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SVL table: A table in storage that is used to contain the 
number of registers to be stored, the address of the 
procedure to which control is passed, and other descriptive 
control information. 


synchronous: Pertains to arising, existing, or happening 
precisely at the same time. | 


system control adapter (SCA): An interface used in 
conjunction with the CE/operator panel for initiating and 
monitoring the system during system initiation. 


system specialization: The tailoring of the system 
(programming and devices) for installation and the 
redefinition of the system when the user adds a device or 
feature or changes some part of the programming. 


system unit: The main unit of the system, which contains 
the processing unit, the system console keyboard/display, 
the operator/service panel, the diskette magazine drive, 
main sotrage, auxiliary storage, the work station controller, 
and the communications subsystem. 


tag: One or more characters, attached to a set of data, that 
contains information about the set, including its 
identification. 


task dispatching element (TDE): An IMP (internal 
microprogramming) object used to identify a task and the 
attributes associated with that task. 


task dispatching queue (TDQ): An IMP (internal 
microprogramming) object used by the task dispatcher to 
allocate processor time to the dispatchable tasks in the 
system. 


tasking: The process of controlling the execution of IMP 
(internal microprogramming) tasks. 


tasks: (1) A semi-independent unit of work that can be 
performed concurrently with other tasks and requires 
coordination with other tasks only at certain points within 
the execution. (2) Units of work activated by the task 
dispatcher. 


TDE: Task dispatching element. 


TDQ: Task dispatching queue. 


terminated: A term used to describe the action the system 
takes when an exception occurs during the execution of an J 
instruction. The instruction is terminated at the point of 

the exception with unpredictable results and the IAR is 

advanced to the next instruction address. The ILC indicates 

the length of the terminated instruction. 


time quantum: The time span remaining for a task to 
execute. 


time-of-day clock: The object used by the system to 
accumulate time within the system. 


TOD: Time of day. 


trap: (ISO) An unprogrammed conditional jump to a 
specified address that is automatically activated by 
hardware. (2) A recording being made of the location from 
which the dump occurred. 


trapped instructions: See trap. 

V=R: Virtual address equals real address. 

V=V: Virtual address equals virtual address. 

VAT: Virtual address translator. } 
vertical microcode (VMC): Microcode that defines logical 

operations on data, is primarily sequential in execution and 

supports the System/38 machine instruction set. 

virtual = real: The planned occurrence in addressing when a 

virtual address addresses the same part of memory as the 


real address. 


virtual address: The address of a storage location in virtual 
storage. 


virtual address translator (VAT): Hardware which converts a 
virtual storage address to a real storage address. 


virtual storage: The combination of main storage and 
auxiliary storage, treated as a single addressable unit. 


VMC: Vertical microcode. 
word: 32 bits or 4 bytes on an integral boundary. 
zone: The leftmost 4 bits of a byte in a decimal field are 


called zone, except for the rightmost byte of the field, 
where these bits may be treated either as a zone or as a 


sign code. 
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extended mnemonics 2-18 
extended operation code assignments B-2 
extender (E) D-3 
extension field 2-16 


F 


fetch next command 7-39 

fetch next command, format 7-39 
FIB (see fill instruction buffer) 

field replaceable unit D-3 

fill instruction buffer (FIB) D-3 

first available hold record 2-25, 9-31 
floating point 


bias 2-6 
biased exponent 2-6 
data 


alignment 2-6 
numerical value 2-5 
exceptions 2-10, 6-4 
exponent 2-6 
infinity 2-6 
long format 2-6 
masked not-a-number 2-7 
minimum bias 2-6 
normalization 2-9 
not-a-number 2-7 
numbers 
denormalization 2-6 
real 2-6 
representation 2-6 
symbolic 2-7 
rounding 2-10 
short format 2-6 
sign bit 2-10 
signed exponent 2-6 
signed zero 02-0010 
significand 2-5 
unmasked not-a-number 2-7 
floating-point format D-3 
floating-point inexact result 
exception 6-19 
floating-point invalid operand 
exception 6-19 
floating-point overflow exception 6-19 
floating-point underflow exception 6-21 
floating-point zero divide exception 6-22 
FOB (see function operation block) 
FOB commands 7-77 
format of instructions 10-1 
format's minimum D-4 





formats and examples 2-16 
fraction D-4 
FRAT (see function routine address table) 
free D-4 
FSTAT (see functional status) 
function call flow 9-44 
function call linkage 9-44 

function call flow diagram 9-45 

function call stack usage 9-44 

function routine address table 

(FRAT) 9-44 
function event 

address event 7-39 

command end 7-39 

command end/fetch next command 

definition D-4 

error event 7-39 

fetch next command 7-39 

load-multiple |/O register 7-18 
function operation block (FOB) 

command/response fields 7-20 

definition D-4 

description 7-17 

format 7-18 

halt device 7-78 

programming notes 7-20 

read event 7-78 

start channel 7-78 

Start device 7-78 

time-out 7-44 

time-out operation 7-45 
function routine address table 
(FRAT) 9-44 

definition D-4 

description 9-44 

in control address table 2-25 
functional status (FSTAT) D-4, 7-43 


G 


gap length D-4 

gap offset D-4 
glossary D-1 
greater than (>) D-4 
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halfword D-4 

halt device command 7-78 

handling of program exceptions 
completed 2-24 
nullified 2-24 
suppressed 2-24 
suspended 2-24 
terminated 2-24 

hard machine check 9-7 
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hardware 
adapters 4-3 
instruction set 1-1 
registers 2-2, 7-35 


tags 
quadword 9-36 
tag bit 9-36 


hardware adapters 4-3 
hardware instruction set. 1-1 
hash hold table (HHT) 
address translation 2-13 
alignment 2-12 
assigned virtual storage location 
definition D-4 
entry 8-4 
in control address table 2-26 
in hold chain structure 9-31 
lookup 
address compression 8-4 
description 8-4 
hashing 8-4 
hash synonyms D-4 
hashing D-3, 8-4 
HHT (see hash hold table) 
HMC (see horizontal microcode) 
HMC initialization 9-2 
hold D-4 
hold chain structure 
first hold record 9-31 
hold free data/fields 9-32 
hold hash table 9-31 
programming note 9-31 
hold/free data field formats 9-32 
hold/free data fields 9-32 
hold/free function 9-31 
hold record (HR) D-4 
hold record area D-4, 9-31 
horizontal microcode (HMC) 
built-in functions 5-1 
definition D-4 
description 1-1, 3-1 
event signaling 3-2 
exceptions 6-10 
1/O event handler 3-2 
initialization 9-2 
interval timer 3-2 
overlay area 2-26 
page fault 3-2 
procedure 3-1, 5-1 
support functions 3-1 
task dispatcher 3-2 
HR (see hold record) 
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| (immediate data operand) D-4 
|/O addressing restrictions 7-37 
|/O and asynchronous events 
channel interface 7-1 
1/O channel (lIOC) 7-1 
1/O manager (IOM) 7-1 
1/O structure 7-1 
operational unit task 7-6 
1/O channel (IOC) 7-1 
1/O command responses 7-42 
1/O devices 4-3 
\/O errors 7-73 
channel errors 7-76 
operational unit errors 7-73 
1/O event 
fields 
address event 7-39 
error event 7-39 
function event 7-38 
handler 
as microcode function 3-2 
description 4-3 
overview 7-40 
task control 4-3 
stack 
|/O event fields 7-41 
in control address table 2-26 
programming notes 7-41 
1/O examples 7-45 
1/O interruptibility 5-2 
|/O manager (IOM) 7-1 
|1/O manager queue D-4 
|1/O manager queue (IOMQ) 
description 7-4 
format 7-11 
operation request element (ORE) 7-11 
programming notes 7-11 
1/O operations 4-3 
1/O register table D-4 
assigned virtual storage location 2-26 
definition D-4 
1/O event field 7-41 
programming notes 7-41 
queue control table (QCT) 7-41 
|/O resolved address registers 
command registers 7-35 
data registers 7-35 
hardware registers 7-35 
multiple contiguous 7-35 
number assigned 7-35 
resolved virtual addresses 7-35 
system initialization time 7-35 
system specialization time 7-35 
|/O status fields 7-42 
1/O storage addressing 7-35 
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|/O storage addressing, address 
registers 7-35 
1/O structure 7-1 
IAR (see instruction address register) 
idle processor state 5-1 
if you need more information — xii 
ILC (see instruction length count) 
immediate data operands D-4, 2-14 
IMP (see internal microprogramming) 
IMP objects D-4, 7-8 
IMPL (see initial microprogram load) 
implicit 
designation D-5, 2-14 
invocation D-5 
operands 2-14 
receive SVL 6-7 
send SVL 6-7 
SVLs_ 10-1 
implicit leading bit D-5 
implied length D-5, 2-14 
inexact result D-5 
infinity D-5, 2-6, 2-10 
infinity arithmetic D-5 
initial microprogram load (IMPL) 
definition D-5 
description 9-2 


functions 
basic hardware tests 9-2 
device 9-2 


HMC initialization 9-2 
loading control and main storage 9-2 
required parameters 9-2 
initial program load (IPL) D-5 
initialization 9-2 
initialization time 7-35 
input/output D-5 
input/output and asynchronous events 4-3 
input/output controller (IOC) D-5 
input/output manager (IOM) D-5 
instruction 
address register (IAR) D-5, 2-17 
address register settings 6-26 
alignment 2-12 
descriptions 
formats (see also Chapter 2) 2-16 
implicit SVLs_ 10-1 
examples 2-16 
length count (ILC) D-5, 6-26 
name-mnemonic cross reference C-1 
operands 2-14 
Operation code extenders 2-16 
operation codes 2-14 
integral boundary D-5 
intermediate denormalized floating-point 
number D-5 
intermediate result D-5 
internal microprogramming (IMP) 
exceptions 6-10 
instruction formats 2-16 
instruction set 10-1 


internal microprogramming (IMP) (continued) 
machine check procedure 9-11 
machine checks 9-/7 
objects 
definition 2-11 
description 211 
descriptors 2-11 
send/receive counter (SRC) 5-13 
send/receive message (SRM) 5-12 
send/receive queue (SRQ) 5-10 
task dispatching element (TDE) 5-4 
task dispatching queue (TDQ) 5-4 
operational unit (OU) numbers 7-9 
procedure 5-1 
structure 2-1 
tasking 5-3 
timer support 9-4 
interruptible instructions 5-15 
interruption of instructions 2-17 
interruptions 2-18 
interrupts 5-2 
pending 5-2 
tests for 5-2 
intertask communications 5-18 
example 5-18 
intertask synchronization 5-18 
example 5-20 
interval timer 
as microcode function 3-2 
definition D-5 
format 9-5 
programming note 9-5 
repetitive 9-5 
second interval timer 9-5 
task interval timer 9-5 
intervention required signal 7-44 
invalid 
definition — xii 
descriptor exception 6-18 
floating-point conversion 
exception 6-22 
floating-point operand 6-19 
operation codes 6-7 
page exception 6-22 
pin request exception 6-22 
pool state exception 6-22 
segment exception 6-22 
segment group address exception 6-22 
write request exception 6-23 
invocation D-5 
IOC (see input/output controller) 
IOM (see input/output manager) 


J 


J (see jump displacement) 
Jump displacement (J) D-5, 2-16 


K 


keyboard 4-3 


L 


L (operand length) D-6 
LB (see lookaside buffer) 
length conformance exception 6-23 
length of fields, explicit 2-3 
length of fields, implied 2-3 
load-multiple |/O register function 
event /-18 
load-unique |/O resolved address 
register /7-18 
loading control and main storage 9-2 
loading state of task 3-2 
LOB (see loop operation block) 
local storage register D-6 
long format D-6 
description 2-6 
range of magnitude 2-7 
values 2-7 
lookaside buffer (LB) D-6, 8-9 
loop operation block (LOB) 
definition D-6 
description 7-23 
format 7-23 
programming notes 7-24 


M 


M (mask operand) D-6 
machine check 
definition D-6 
during translate instruction 9-28 
handler 2-26 
handling 
check stop 9-7 
check stop state 9-7 
description 9-7 
machine check mode 9-7 
hard 9-7 
IMP machine check 9-8 
log 9-12 
mode 9-8 
procedures 9-9 


machine check (continued) 
soft 9-7 
special error conditions 9-28 
machine check log buffer (MCLB) 
definition D-6 
format 9-13 
in control address table 2-26 
machine check log 9-12 
processor status 9-12 
task status 9-12, 9-26 
machine communications area (MCA) D-6 
machine interface (MI) D-6 
machine product 
hardware 1-1 
horizontal microcode (HMC) 1-1 
microcode 1-1 
vertical microcode (VMC)_ 1-1 
machine support functions 
initial microprogram load (IMPL) 9-2 
internal microprogramming timer 
support 9-4 
machine check 9-7 
program event monitoring (PEM) 9-3 
stack handling 9-29 
system control 9-6 
main storage (see real storage) D-6 
main storage error exception 6-23 
masked not-a-number 2-7 
maximum value 2-3 
message operation block (MOB) 
definition D-6 
description 7-24 
format 7-25 
programming notes 7-25 
microcode D-6, 1-1 
microprocessor stopped state 4-2 
minimum bias 2-6 
minimum value 2-3 
minemonic-instruction name cross 
reference C-1 
mnemonic-operation code cross 
reference B-1 
MOB (see message operation block) 
modification of hash table entries 8-10 
modification of primary directory 
entries 8-10 
monitor D-6 
monitored SRM descriptor 6-23 
monitored SRQ descriptor 6-23 
monitored TDE descriptor 6-23 
monitored ACQ exception 6-23 
monitored CRE exception 6-23 
monitored SRM descriptor exception 6-23 
monitored SRQ descriptor exception 6-23 
monitored TDE descriptor exception 6-23 
MSAR (see main storage address register) 
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Nan (see not-a-number) 
negative infinity (see infinity) 
no-operation D-6 
normalization 2-9 
normalized number D-6 
not-a-number D-6, 2-7 
not used xii 
notes xii 
nullified instructions D-6, 2-24 
number 

denormalized 2-6 

floating point 2-5 

real 2-6 

symbolic 2-7 


O 


OB (see operation blocks) 
object OD-005 
object address 9-33 
objects (IMP) 
alignment 2-12 
definition D-7 
offset D-7, 8-2 
one-byte registers (r) 2-2 
operands 
explicit designation 2-14 
immediate 2-14 
implicit designation 2-14 
implied length 2-14 
referencing diagram 2-15 
register 2-14 
storage 2-14 
operation block 
address operation block (AOB) 7-20 
channel order field 7-4 
definition D-7 
description 7-14 
device order field 7-4 
format 7-14 
function operation block (FOB) 7-17 
loop operation block (LOB) 7-23 
message operation block (MOB) 7-24 
program operation block (POB) 7-16 
operation code 
assignments C-1 
definition D-7 
description 2-14 
extender field 2-16 
extender in MCLB 9-22 
mnemonic cross reference B-1 
operation exception 6-23 


operation program 

definition D-7 

description 7-26 

error recording 7-74 

errors 7-74 

example 7-26 

programming notes 7-28 
operation request element (ORE) 

definition D-7 

description 7-12 

format 7-12 

operation block 7-4 

programming notes 7-13 

response field (BSTAT) 7-4 
operational state 4-2 
operational unit (OU) 

assignment of OU numbers 7-9 

definition D-7 

|/O device addressing 7-9 

programming notes 7-9 

response field 7-4 
operational unit error 

description 7-73 

device errors 7-74 

error recovery procedures 7-76 

operation program error recording 7-74 

operation program errors 7-7/4 

operation unit error recovery 7-74 

recovery 7-74 

task error status field 7-74 
operational unit number one 9-6 
operational unit numbers D-7 
operational unit numbers, assignment 7-9 
operational unit queue (OUQ) 

definition D-7 

description 7-10 

format 7-11 

programming notes 7-10 
operational unit status fields 

basic status (BSTAT) 7-42 

device status (DSTAT) 7-43 

functional status (FSTAT) 7-43 

intervention required signal 7-44 
operational unit task 

base register assignments 7-8 

command completion functions 7-6 

definition D-7 

description 4-3, 7-6 

invoked 7-6 

storage and |/O interface 4-3 
operator/service panel 4-3, 9-6 
ORE (see operation request element) 
organization of this manual xi 
OUQ (see operational unit queue) 
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packed data format 2-4 


page 
boundary crossing 7-35 
chain stack 7-35 
chaining 
description 7-35 
event handler 7-35 
definition D-/7, D-7, 8-2 
fault 
definition D-7 
description 7-36, 8-2 
exception code 6-10 
HMC built-in function 3-2 
frame 
definition D-/7 
description 8-2 
identifier (PID) 
definition D-7 
description 8-2 
read error exception 6-23 
pending interrupts 5-2 
permanent storage assignments D-/7, 2-25 
PID (see page identifier) 
pin count (PINCNT) D-7 
pinning D-7 
placeholder D-7 
PMCH (see processor machine check) 
PMCH state chart 9-16 
POB (see program operation block) 
pointer to data area 9-42 
% positive infinity (see infinity) 
post event 7-/6 
preempt wait D-8 
preferred sign and digit codes 2-5 
prefetched instructions 2-17 
primary directory (PD) 
address translation 2-13 
alignment 2-12 
assigned virtual storage location 2-26 
definition D-8 
description 8-6 
entry 8-6 
entry format 8-6 
in control address table 2-26 
lookup 8-8 
storage address formation 8-9 
prime TDQ 2-26, 5-4 
procedure D-8 
procedure execution 5-1 
processing unit (CPU) D-8 
processor 4-1 
processor machine check handler (PMCH) 
definition D-8 
procedure 9-9 
restart task 9-10 
stop state machine check 9-10 


processor machine check handler (PMCH) (continued) 
trapping 9-8 
wait state machine check 9-10 
processor machine check procedure 9-9 
processor states 
operational 4-2 
stopped 4-2 
processor status 9-12, 9-14 
processor stopped state 4-2 
program event monitor (PEM) 
definition D-8 
programming note 9-3 
start address 9-3 
stop address 9-3 
program event monitoring exception 6-24 
program exceptions 
address compare 6-14, 9-41 
address translation 6-14 
addressing 6-15 
allocate page frame 6-15 
binary divide 6-15 
binary overflow 6-15 
cause 2-24, 6-14 
chain conflict 6-15 
data exception 6-16 
decimal overflow 6-16 
decimal zero divide 6-16 
description 2-19 
descriptor access 6-16 
edit digit count 6-17 
edit mask syntax 6-17 
effective address overflow 6-17 
end-of-chain 6-18 
execute 6-18 
floating-point inexact result 6-19 
floating-point invalid operand 6-19 
floating-point overflow 6-19 
floating-point underflow 6-21 
floating-point zero divide 6-22 
handling 2-24 
invalid descriptor 6-18 
invalid floating-point conversion 6-22 
invalid page 6-22 
invalid pin request 6-22 
invalid pool state 6-22 
invalid segment 6-22 
invalid segment group address 6-22 
invalid write request 6-23 
length conformance 6-23 
main storage error 6-23 
monitored ACQ 6-23 
monitored CRE 6-23 
monitored SRM (descriptor) 6-23 
monitored SRO (descriptor) 6-23 
monitored TDE (descriptor) 6-23 
operation 6-23 
page read error 6-23 
program event monitoring 6-24 
second chain search 6-24 
send/receive counter overflow 6-24 
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program exceptions (continued) 
specification 6-24 


stack 6-26 
task interval timer 6-26 
verify 6-26 


program operation block (POB) 
definition D-8 
format 7-16 
programming notes 7-1/7 
programming notes xi 
purpose of this manual xi 
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QCT (see queue control table) 
quadword D-8, 9-33 
queue D-8 
queue control table (QCT) 
definition D-8 
description 7-28 
event stack 
description 7-32 
format 7-29 
programming notes 7-33 
format 7-29 
location of 7-41 
programming notes 7-32 
queue interface 4-3 


R 


r (one-byte register) D-8 
R (two-byte register) D-8 
range of magnitude 2-7 
read event command 7-78 
real numbers 2-6 
real storage D-8 
reference and change recording 8-10 
register, address D-1, 7-35 
register descriptions 
base registers (B) 2-2 
hardware registers 2-2 
one-byte registers (r) 2-2 
segment identifier registers (S) 2-2 
two-byte registers (R) 2-2 
register loading 6-9 
register operands 2-14 
register to register (see RR) 
register to storage (see RS) 
registers SO and RO 2-18 
repetitive interval timers 2-26, 9-5 
replenishing the ACO with CREs_ 6-10 
reserved xii 
reserved values D-8 
resolved address D-8 
resolved address register (RAR) 7-35 
resolved virtual addresses 7-35 


response field /-4 

restart task 9-10 

result field D-8 

result offset D-8 

RI (register to immediate) D-8 
rotary switches D-8 

round to nearest D-8 

round toward negative infinity D-8 
round toward positive infinity D-8 
rounding D-8, 2-10 

rounding toward zero D-9 

RR (register to register) D-9 

RS (register to storage) D-8 


Ss 


saving/restoring 6-2 
SCA (see system control adapter) 
scalar D-9 
second chain search exception 6-24 
second interval timer 9-5 
segment D-9J, 8-2 
segment group 9-46 
segment identifier (SID) D-9, 8-2 
segment identifier registers (S) 2-2 
send/receive counter (SRC) 
definition D-9 
description 5-13 
for clock comparator 2-26 
for interval timer 2-26 
format 5-13 
overflow exception 6-24 
send/receive message (SRM) 
definition D-9 
description 5-12 
format 5-12 
send/receive queue (SRQ) 
busy status 5-15 
definition D-9 
description 5-10 
exchange intertask information 5-10 
format 5-12, 7-11 
interruptible instructions 5-15 
task synchronization 5-10 
sequential execution 2-17 
service panel 4-3 
set D-9J 
short format D-9 
description 2-6 
range of magnitude 2-7 
values 2-7 
SI (storage to immediate) D-9 
SID (see segment identifier) 
sign and digit codes 2-5 
sign bit 2-10 
signed exponent D-9, 2-6 
signed zero D-9, 2-10 
significand 2-5 


significant D-9 
soft machine check 9-7 
source offset D-9 
source operand D-9 
source record length D-9 
source/sink D-9 
space pointers 
alignment 2-12 
format 9-46 
processing 9-46 
segment group header 9-48 
special interrupt test 5-2 
specification exception 6-24 
SRC (see send/receive counter) 
SRM (see send/receive message) 
SRQ (see send/receive queue) 
SS (storage to storage) D-9 
stack D-10 
stack exception 6-26 
stack handling 
hardware tags O9-036.1 
hold chain structure 9-31 
hold/free function 9-31 
stack structure 9-29 
stack structure 9-29 
start address 9-3 
start channel command 7-78 
start device command 7-78 
start of the instruction stream 5-2 
statistical data recording D-10 
status of procedure 6-3, 6-9 
status of task 5-17 
Status retention 9-44 
stop address 9-3 
stop state machine check 9-10 
stopped state 
(see also Check Stop in Chapter 9) 
check stopped 4-2 
microprocessor stopped 4-2 
processor stopped 4-2 
storage 
address 2-17 
address formation 8-9 
capacity D-10, 2-3 
cycle 2-3 
descriptions 2-1 
operand addressing 2-17 
operands 2-14 
width D-10, 2-3 
storage to immediate (see Sl) 
storage to storage (see SS) 
storing state of task 3-2 
string D-10 
supervisor exit 6-12 
supervisor linkage (SVL) 
available CRE queue (ACQ) 6-6 
call/return element (CRE) 6-3 
concepts 6-1 
definition D-10 
description 2-18 


supervisor linkage (SVL) (continued) 
exception mask 6-9 
exception presentation 6-1 
interruptions 2-18 
mechanism 6-2 
register loading 6-9 
replenishing the ACQ with CREs_ 6-10 
saving/restoring 6-2 
status of the procedure 6-9 
summary 6-12 
table 6-6 
trapping instructions 2-18 
supervisor linkage and exception 
presentation 6-1 
supervisor linkage control 
descriptor access exceptions 6-12 
exception signaling 6-7 
HMC exceptions 6-10 
IMP exceptions 6-10 
operation code hex OO and hex 40 6-7 
page fault 6-10 
program to program 6-7 
programming note 6-12 
register loading 6-9 
supervisor exit 6-12 
trapped instructions 6-7 
trapped operation code 6-10 
trapped operations 6-10 
supervisor linkage structures 
available CRE queue (ACQ) 6-6 
call/return element (CRE) 6-3 
supervisor linkage table 6-6 
supervisor linkage table D-10 
definition D-10 
description 6-6 
format 6-6 
suppressed instructions D-10, 2-24 
suspended instructions D-10, 2-24 
SVL (see supervisor linkage) 
symbolic numbers 
infinity 2-6 
not-a-number 2-7 
symbols used in instruction formats 2-16 
synchronous D-10 
system console 
description 4-3, 9-6 
display 4-3 
keyboard 4-3 
operator/service panel 4-3, 9-6 
system control 
system console 9-6 
system control adapter 9-6 
system control adapter (SCA) 
command field 9-6 
definition D-10 
description 9-6 
during stopped state 4-2 
operational unit number one 9-6 
system control queue 9-6 
system maintenance 9-6 
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system control instructions 2-13 
system control queue 9-6 
system features 1-1 
system initialization time 7-35 
system maintenance 9-6 
system specialization time D-10, 7-35 
System/38 |/O structure 7-3 
System /38 instruction set 1-1 
system units 
address registers 7-35 
hash table 8-4 
machine check log buffer 9-13 
MVMC 10-278.1 
processor status 9-19, 9-20.1, 9-26, 9-27 
translation process 8-2 
use code 2-26 


T 


tag bit D-10, 9-36 
target send/receive counter 9-4 
task control 
enable/disable functions 5-17 
task dispatching 5-16 
task switching 5-17 
task timing 5-17 
task control mode 5-10 
task dispatching 
active task 3-2 
current task 3-2 
description 3-2, 5-16 
task dispatching element (TDE) 
current state of task 5-4 
definition D-10 
disable PEM mode_ 5-10 
format 5-5 
maskable exception 5-10 
task control mode 5-10 
task dispatching queue (TDQ) 
chained list 3-2 
definition D-10 
dispatchable tasks 5-4 
format 5-4 
prime 5-4 
task error status field 7-73 
task interval timer 
decremented through zero 6-26 
description 9-5 
expiration 6-26 
in CRE 6-4 
task timing 5-17 
task status 9-12, 9-26 
task switch operation 9-40 
task switch trace record, 
description 9-39 
task switch trace record, format 9-39 
task switching 5-17 
task synchronization 5-11 
example 5-20 
task timing 5-17 
task timing, task interval timer 5-17 
task, dispatching 
active task 3-2 
current task 3-2 
description 3-2 
invoking task dispatcher 5-16 
task switch 5-17 
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task, dispatching (continued) 
tasking structure 5-4 
tasking 
definition D-10 
description 5-1 
status of task 5-17 
task dispatching 5-17 
wait state 5-1/7 
tasking structure 
send/receive counter (SRC) 5-13 
send/receive message (SRM) 5-12 
send/receive queue (SRQ) 5-10 
task dispatching element (TDE) 5-4 
task dispatching queue (TDQ) 5-4 
tasks D-10 
TDE (see task dispatching element) 
TDQ (see task dispatching queue) 
terminated instructions D-10, 2-24 
terminology 
invalid xii 
not used _ xii 
reserved xii 
time-of-day clock (TOD) 
definition D-10 
format 9-4 
time quantum D-10 
TOD (see time-of-day clock) 
trace control table 
description 9-37 
format 9-38 
translation process 
byte identifier (BID) 8-2 
page 8-2 
page identifier (PID) 8-2 
programming note 8-3 
segment 8-2 
segment identifier (SID) 8-2 
virtual = real addressing 8-2 
virtual = virtual addressing 8-2 
trap D-10 
trapped instructions 
definition D-10 
description 6-7 
operation 6-10 
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